/EXPORT (Exporta una función)

Actualización: noviembre 2007

/EXPORT:entryname[,@ordinal[,NONAME]][,DATA]

Comentarios

Esta opción permite exportar una función desde el programa, de modo que otros programas también puedan llamarla. Permite además exportar datos. Las exportaciones se suelen definir en archivos DLL.

El argumento entryname es el nombre de la función o del elemento de datos tal como va a ser utilizado por el programa que realiza la llamada. El argumento ordinal especifica un índice para la tabla de exportaciones en el intervalo de 1 a 65535; si no se especifica ordinal, LINK asigna uno. La palabra clave NONAME sólo exporta la función como un valor ordinal, sin un valor de entryname.

La palabra clave DATA especifica que el elemento exportado es de datos. El elemento de datos del programa cliente debe declararse mediante extern __declspec(dllimport).

Existen tres métodos para exportar una definición, que se indican en el orden de uso recomendado:

  1. __declspec(dllexport) en el código fuente.

  2. Una instrucción EXPORTS en un archivo .def.

  3. Una especificación /EXPORT en un comando LINK

Los tres métodos se pueden utilizar en el mismo programa. Cuando LINK genera un programa que contiene exportaciones, crea además una biblioteca de importación, a menos que se utilice un archivo .exp en la generación.

LINK usa formatos representativos para los identificadores. El compilador decora los identificadores cuando crea el archivo .obj. Si se especifica entryname para el vinculador en su formato no representativo (tal como aparece en el código fuente), LINK intentará encontrar el nombre. Y, si no encuentra una única coincidencia, generará un mensaje de error. La herramienta DUMPBIN se utiliza para obtener el formato de nombres representativos de un identificador que necesite especificarse en el vinculador.

Nota:

No se debe especificar la forma representativa de los identificadores de C declarados con __cdecl o __stdcall.

Para establecer esta opción del vinculador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para obtener más información, vea Establecer las propiedades de un proyecto de Visual C++.

  2. Haga clic en la carpeta Vinculador.

  3. Haga clic en la página de propiedades Línea de comandos.

  4. Escriba la opción en el cuadro Opciones adicionales.

Para establecer esta opción del vinculador mediante programación

Vea también

Referencia

Establecer las opciones del vinculador

Opciones del vinculador