¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

comment (C/C++)

Inserta un registro de comentario en un archivo objeto o ejecutable.

#pragma comment( comment-type [,"commentstring"] )

El elemento comment-type es uno de los identificadores predefinidos (se describe más adelante), que especifica el tipo de registro del comentario. El elemento commentstring opcional es un literal de cadena que proporciona información adicional para algunos tipos de comentario. Dado que commentstring es un literal de cadena, obedece todas las reglas para los literales de cadena con respecto a los caracteres de escape, las comillas incrustadas (") y la concatenación.

compiler

Coloca el nombre y número de versión del compilador en el archivo objeto. Este registro de comentario es ignorado por el vinculador. Si se proporciona un parámetro commentstring para este tipo de registro, el compilador genera una advertencia.

exestr

Coloca commentstring en el archivo objeto. En el momento de la vinculación, esta cadena se coloca en el archivo ejecutable. La cadena no se carga en memoria cuando el archivo ejecutable se carga; sin embargo, puede ser encontrada con un programa que busque cadenas imprimibles en archivos. Un uso para este tipo de registro de comentario es incrustar un número de versión o información similar en un archivo ejecutable.

exestr está desusado y se quitará en una futura versión; el vinculador no procesa el registro de comentario.

lib

Inserta un registro de búsqueda de biblioteca en el archivo objeto. Este tipo de comentario debe ir acompañado de un parámetro commentstring que contenga el nombre (y posiblemente la ruta de acceso) de la biblioteca que desea que el vinculador busque. El nombre de biblioteca sigue los registros de búsqueda de biblioteca predeterminados en el archivo objeto; el vinculador busca esta biblioteca como si se hubiera designado en la línea de comandos, siempre que la biblioteca no se especifique con /nodefaultlib. Puede colocar varios registros de búsqueda de biblioteca en el mismo archivo de código fuente; cada registro aparece en el archivo objeto en el mismo orden en el que se encuentra en el archivo de código fuente.

Si el orden de la biblioteca predeterminada y una biblioteca agregada es importante, la compilación con el modificador /Zl evitará que el nombre de biblioteca predeterminado se sitúe en el módulo de objeto. Entonces, se puede usar una segunda directiva pragma de comentario para insertar el nombre de biblioteca predeterminada después de la biblioteca agregada. Las bibliotecas incluidas con estas directivas pragma aparecerán en el módulo de objeto en el mismo orden en que se encuentran en el código fuente.

linker

Coloca una opción del vinculador en el archivo objeto. Puede utilizar este tipo de comentario para especificar una opción del vinculador en lugar de pasarla a la línea de comandos o de especificarla en el entorno de desarrollo. Por ejemplo, puede especificar la opción /include para forzar la inclusión de un símbolo:

#pragma comment(linker, "/include:__mySymbol")

Solo las siguientes opciones del vinculador (comment-type) están disponibles para pasarlas al identificador del vinculador:

usuario

Coloca un comentario general en el archivo objeto. El parámetro commentstring contiene el texto del comentario. Este registro de comentario es ignorado por el vinculador.

La siguiente directiva pragma hace que el vinculador busque la biblioteca EMAPI.LIB durante la vinculación. El vinculador busca primero en el directorio de trabajo actual y en la ruta de acceso especificada en la variable de entorno LIB.

#pragma comment( lib, "emapi" )

La directiva pragma siguiente hace que el compilador coloque el nombre y el número de versión del compilador en el archivo objeto:

#pragma comment( compiler )
NotaNota

Para los comentarios que toman un parámetro commentstring, se puede utilizar una macro en cualquier lugar donde utilizaría un literal de cadena, siempre que la macro se expanda a un literal de cadena. También puede concatenar cualquier combinación de literales de cadena y macros que se expandan a literales de cadena. Por ejemplo, la siguiente instrucción es aceptable:

#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ ) 

Adiciones de comunidad

Mostrar:
© 2015 Microsoft