Compartir a través de


Exportar desde un archivo DLL mediante __declspec(dllexport)

Puede exportar datos, funciones, clases o funciones miembro de clase desde un archivo DLL mediante la palabra clave __declspec(dllexport). __declspec(dllexport) agrega la directiva de exportación al archivo objeto, por lo que no es necesario usar un archivo .def.

Esto resulta especialmente cómodo cuando se intenta exportar nombres de función representativos de C++. Dado que no hay ninguna especificación estándar para la decoración de nombres, el nombre de una función exportada podría cambiar entre versiones del compilador. Si usa __declspec(dllexport), únicamente necesita volver a compilar el archivo DLL y los archivos .exe dependientes para tener en cuenta los cambios en la convención de nomenclatura.

Muchas directivas de exportación (como los ordinales, NONAME y PRIVATE) solo se pueden realizar en un archivo .def y no hay ninguna manera de especificar estos atributos sin un archivo .def. Aun así, el uso de __declspec(dllexport) junto con un archivo .def no produce errores de compilación.

Para exportar funciones, la palabra clave __declspec(dllexport) debe aparecer a la izquierda de la palabra clave de la convención de llamada, si se especifica una palabra clave. Por ejemplo:

__declspec(dllexport) void __cdecl Function1(void);

Para exportar todos los miembros de datos públicos y las funciones miembro de una clase, la palabra clave debe aparecer a la izquierda del nombre de clase como se indica a continuación:

class __declspec(dllexport) CExampleExport : public CObject
{ ... class definition ... };

Nota:

__declspec(dllexport) no se puede aplicar a una función con la convención de llamada __clrcall.

Al compilar el archivo DLL, normalmente se crea un archivo de encabezado que contiene los prototipos de función o las clases que se están exportando y se agrega __declspec(dllexport) a las declaraciones del archivo de encabezado. Para que el código sea más legible, defina una macro para __declspec(dllexport) y úsela con cada símbolo que vaya a exportar:

#define DllExport   __declspec( dllexport )

__declspec(dllexport) almacena nombres de función en la tabla de exportación del archivo DLL. Si quiere optimizar el tamaño de la tabla, vea Exportación de funciones desde un archivo DLL por ordinal en lugar de por nombre.

¿Qué desea hacer?

¿Qué más desea saber?

Consulte también

Exportación desde un archivo DLL