Compartir a través de

/Yl (Insertar referencia PCH para biblioteca de depuración)

  • Artículo

La opción /Yl genera un símbolo único en un archivo de encabezado precompilado y se inserta una referencia a este símbolo en todos los archivos de objeto que usan el encabezado precompilado.

Sintaxis

/Yl
/Ylname
/Yl-

Argumentos

name
Nombre opcional que se usa como parte del símbolo único.

-
Un guión (-) deshabilita explícitamente la opción del compilador /Yl.

Comentarios

La opción del compilador /Yl crea una definición de símbolo única en un archivo de encabezado precompilado creado mediante la opción /Yc. Las referencias a este símbolo se insertan automáticamente en todos los archivos que incluyen el encabezado precompilado mediante la opción del compilador /Yu. La opción /Yl está habilitada de forma predeterminada cuando se usa /Yc para crear un archivo de encabezado precompilado.

La opción de nombre/Yl se usa para crear un símbolo identificable en el archivo de encabezado precompilado. El compilador usa el argumento name como parte del nombre de símbolo representativo que crea, similar a __@@_PchSym_@00@...@name, donde los puntos suspensivos (...) representan una cadena de caracteres única generada por el compilador. Si se omite el argumento name, el compilador genera automáticamente un nombre de símbolo. Normalmente, no es necesario conocer el nombre del símbolo. Sin embargo, cuando el proyecto usa más de un archivo de encabezado precompilado, la opción /Ylname puede ser útil para determinar qué archivos de objeto usan el encabezado precompilado. Puede usar el nombre como una cadena de búsqueda para buscar la referencia de símbolos en un archivo de volcado de memoria.

/Yl: deshabilita el comportamiento predeterminado y no coloca un símbolo de identificación en el archivo de encabezado precompilado. Los archivos compilados que incluyen este encabezado precompilado no obtienen una referencia de símbolo común.

Cuando no se especifica /Yc , ninguna opción /Yl no tiene ningún efecto, pero si se especifica debe coincidir con cualquier opción /Yl pasada cuando se especifica /Yc.

Si usa las opciones /Yl-, /Yc y /Z7 para compilar un archivo de encabezado precompilado, la información de depuración se almacena en el archivo de objeto para el archivo de origen usado para crear el encabezado precompilado, en lugar de un archivo .pdb independiente. Si este archivo de objeto forma parte de una biblioteca, pueden producirse errores LNK1211 o advertencias de LNK4206 en compilaciones que usan esta biblioteca y el archivo de encabezado precompilado, si el archivo de origen usado para crear el archivo de encabezado precompilado no define ningún símbolo en sí. El enlazador puede excluir el archivo de objeto del vínculo, junto con la información de depuración asociada, cuando no se hace referencia a nada en el archivo de objeto en el cliente de biblioteca. Para solucionar este problema, especifique /Yl (o quite la opción /Yl- ) al usar /Yc para crear el archivo de encabezado precompilado. Esto garantiza que el archivo de objeto de la biblioteca que contiene la información de depuración se vincula en la compilación.

Para obtener más información sobre los encabezados precompilados, consulte:

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

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione la página de propiedades Propiedades de configuración>C/C++>Línea de comandos.

  3. Agregue la opción del compilador /Ylname en el cuadroOpciones adicionales. Elija Aceptar para guardar los cambios.

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

Consulte también

Opciones del compilador de MSVC
Sintaxis de la línea de comandos del compilador MSVC