En este tema se describe cómo acceder a funciones no administradas y presenta varios campos de atributo que anotan la definición de método en el código administrado. Para obtener ejemplos que muestran cómo construir declaraciones basadas en .NET para usarlas con la invocación de plataforma, vea Serialización de datos con invocación de plataforma.
Antes de poder acceder a una función DLL no administrada desde código administrado, deberá conocer el nombre de la función y el nombre del archivo DLL que la exporta. Con esta información, puede empezar a escribir la definición administrada de una función no administrada que se implementa en un archivo DLL. Además, puede ajustar la manera en que la invocación de plataforma crea la función y calcula las referencias de los datos desde y hacia la función.
Nota
Las funciones de la API de Windows que asignan una cadena permiten liberar la cadena mediante un método como LocalFree. La invocación de plataforma controla estos parámetros de forma diferente. Para las llamadas de invocación de plataforma, haga que el parámetro sea del tipo IntPtr en lugar del tipo String. Use los métodos que proporciona la clase System.Runtime.InteropServices.Marshal para convertir el tipo a una cadena manualmente y liberarla manualmente.
Conceptos básicos de declaración
Las definiciones administradas de funciones no administradas dependen del lenguaje, como puede ver en los ejemplos siguientes. Para obtener ejemplos de código más completos, vea Ejemplos de invocación de plataforma.
Friend Class NativeMethods
Friend Declare Auto Function MessageBox Lib "user32.dll" (
ByVal hWnd As IntPtr,
ByVal lpText As String,
ByVal lpCaption As String,
ByVal uType As UInteger) As Integer
End Class
Imports System.Runtime.InteropServices
Friend Class NativeMethods
<DllImport("user32.dll", CharSet:=CharSet.Auto)>
Friend Shared Function MessageBox(
ByVal hWnd As IntPtr,
ByVal lpText As String,
ByVal lpCaption As String,
ByVal uType As UInteger) As Integer
End Function
End Class
using System;
using System.Runtime.InteropServices;
internal static class NativeMethods
{
[DllImport("user32.dll")]
internal static extern int MessageBox(
IntPtr hWnd, string lpText, string lpCaption, uint uType);
}
using namespace System;
using namespace System::Runtime::InteropServices;
[DllImport("user32.dll")]
extern "C" int MessageBox(
IntPtr hWnd, String* lpText, String* lpCaption, unsigned int uType);
Ajustar la definición
Tanto si se establece explícitamente como si no, los campos de atributo definen el comportamiento del código administrado. La invocación de plataforma funciona según los valores predeterminados establecidos en diversos campos que existen como metadatos en un ensamblado. Puede modificar este comportamiento predeterminado ajustando los valores de uno o más campos. En muchos casos, se usa DllImportAttribute para establecer un valor.
En la tabla siguiente se muestra el conjunto completo de campos de atributo que pertenecen a la invocación de plataforma. Para cada campo, la tabla incluye el valor predeterminado y un vínculo a información sobre cómo usar estos campos para definir funciones DLL no administradas.
Especifica la convención de llamada que se usará al pasar argumentos de método. El valor predeterminado es WinAPI, que corresponde a __stdcall para las plataformas de 32 bits basadas en Intel.
Controla la eliminación de nombres y la forma en que deben serializarse los argumentos de cadena en la función. De manera predeterminada, es CharSet.Ansi.
Controla si un punto de entrada debe modificarse para que coincida con el juego de caracteres. El valor predeterminado varía según el lenguaje de programación.
Controla si la firma del método administrado debería transformarse en una firma no administrada que devuelve un resultado HRESULT y tiene un argumento adicional [out, retval] para el valor devuelto.
El valor predeterminado es true (la firma no debe transformarse).
Permite al llamador usar la función Marshal.GetLastWin32Error de la API para determinar si se produjo un error al ejecutar el método. En Visual Basic, el valor predeterminado es true; en C# y C++, el valor predeterminado es false.
Controla el inicio de una excepción cuando un carácter Unicode que no se puede asignar se convierte en un carácter ANSI "?".
Para obtener información de referencia detallada, vea DllImportAttribute.
Consideraciones sobre la seguridad de la invocación de plataforma
Los miembros Assert, Deny y PermitOnly de la enumeración SecurityAction se conocen como modificadores del recorrido de la pila. Estos miembros se omiten si se usan como atributos declarativos en declaraciones de invocación de plataforma e instrucciones del lenguaje de definición de interfaz (IDL) COM.
Ejemplos de invocación de plataforma
Los ejemplos de invocación de plataforma de esta sección muestran el uso del atributo RegistryPermission con los modificadores del recorrido de la pila.
En el ejemplo siguiente se omiten los modificadores SecurityActionAssert, Deny y PermitOnly.
Los modificadores SecurityAction también funcionan correctamente en un escenario anidado en el que se colocan en el llamador de la llamada de invocación de plataforma:
{
public ref class PInvokeWrapper
public:
[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]
private static extern bool CallRegistryPermissionDeny();
[RegistryPermission(SecurityAction.Demand, Unrestricted = true)]
public static bool CallRegistryPermission()
{
return CallRegistryPermissionInternal();
}
};
Los ejemplos de interoperabilidad COM de esta sección muestran el uso del atributo RegistryPermission con los modificadores del recorrido de la pila.
Las siguientes declaraciones de interfaz de interoperabilidad COM omiten los modificadores Assert, Deny y PermitOnly, de forma similar a los ejemplos de invocación de plataforma de la sección anterior.
Además, el modificador Demand no se acepta en escenarios de declaración de interfaz de interoperabilidad COM, tal y como se muestra en el ejemplo siguiente.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de
.NET
.NET
es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
Utilice funciones DLL no administradas mediante el servicio de invocación de plataforma, que permite que el código administrado llame a funciones no administradas implementadas en bibliotecas DLL.
Revise los problemas relacionados con la llamada a una función DLL que puede parecer confusa. El proceso de llamada de función difiere en función de si el tipo de valor devuelto se puede transferir en bloque de bits.
Serialización de datos con invocación de plataforma en .NET. Vea una lista de tipos de datos que se usan en las API de Windows y funciones de estilo C, y busque sus equivalentes de tipos administrados de .NET.
Aprenda a pasar estructuras y clases a funciones no administradas. Obtenga información sobre el atributo StructLayoutAttribute, que se utiliza para definir tipos con formato.
Comience a trabajar con la serialización de interoperabilidad, que rige cómo se pasan los datos en los argumentos de método y los valores devueltos entre la memoria administrada y la no administrada durante las llamadas.
Revise la interoperación con código no administrado. CLR oculta a los clientes y servidores de qué manera difieren los modelos de objetos de los componentes de .NET y el código no administrado.
