Compartilhar via


/Yl (injetar referência PCH para biblioteca de depuração)

Usado para criar uma biblioteca de depuração que usa cabeçalhos pré-compilados e a compilação falhará.

/Ylsymbol

/Yl-

Arguments

  • symbol
    Um símbolo arbitrário a ser armazenado no módulo de objeto.

  • -
    Um sinal de menos (-) que desabilita explicitamente a opção do compilador de /Yl .

Comentários

Por padrão, o compilador usa a opção de /Yl (sem especificar symbol). A opção de /Yl habilita o depurador para obter informações completas sobre tipos. /Yl- desabilita comportamento padrão.

Quando você cria um módulo com /Yc e /Ylsymbol, o compilador cria um símbolo semelhante ao __@@_PchSym_@00… @ @symbol, onde as reticências (...) representam uma cadeia de caracteres vinculador- gerado, e o coloca no módulo de objeto. Qualquer arquivo de origem que você compile com este cabeçalho pré-compilado se refere ao símbolo especificado, que faz com que o vinculador inclui o módulo de objeto e suas informações de depuração da biblioteca.

Usando esta opção, você pode gerar LNK1211. Quando você especifica as opções de /Yc (criar arquivo de cabeçalho pré-compilado) e de /Z7, /Zi, /ZI (depurar formato de informações) , o compilador cria um arquivo de cabeçalho pré-compilado que contém informações de depuração. Um erro pode ocorrer quando você armazena o cabeçalho pré-compilado em uma biblioteca, usa a biblioteca para criar um módulo de objeto, e o código-fonte não se refere a nenhuma das funções que o arquivo de cabeçalho pré-compilado define o.

Para resolver o problema, especifique /Ylsymbol, onde symbol é o nome de um símbolo arbitrário na biblioteca, quando você cria um arquivo de cabeçalho pré-compilado que não contém nenhuma definições de função. Essa opção direciona o compilador para armazenar informações de depuração no arquivo de cabeçalho pré-compilado.

Para obter mais informações sobre cabeçalhos pré-compilados, consulte:

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedade do projeto. Para obter detalhes, consulte Como abrir páginas de propriedade do projeto.

  2. Clique na pasta C/C++.

  3. Clique na página de propriedades de Linha de Comando.

  4. Digite a opção de compilador na caixa Opções Adicionais.

Para definir essa opção do compilador via programação

Consulte também

Referência

Opções do compilador

Definindo opções do compilador