Partager via


/Yl (Injecter une référence PCH pour une bibliothèque de débogage)

Utilisée lors de la création d'une bibliothèque de débogage qui utilise des en-têtes précompilés et lorsque la génération échoue.

/Ylsymbol

/Yl-

Arguments

  • symbol
    Symbole arbitraire à stocker dans le module objet.

  • -
    Un signe moins (-) qui désactive explicitement l'option /Yl du compilateur.

Notes

Par défaut, le compilateur utilise l'option /Yl (sans spécifier un symbol). L'option de /Yl active le débogueur pour obtenir des informations complètes sur les types. /Yl- désactive le comportement par défaut.

Quand vous compilez un module avec /Yc et /Ylsymbol, le compilateur crée un symbole se présentant comme __@@_PchSym_@00@...@symbol, où les points de suspension (...) représentent une chaîne de caractères générée par le compilateur, et le stocke dans le module objet. Tout fichier source que vous compilez avec cet en-tête précompilé fait référence au symbole spécifié, ce qui amène l'éditeur de liens à incorporer le module objet et ses informations de débogage à partir de la bibliothèque.

Si vous utilisez cette option, vous risquez de générer l'erreur LNK1211. Lorsque vous spécifiez les options /Yc (Créer un fichier d'en-tête précompilé) et /Z7, /Zi, /ZI (Format des informations de débogage), le compilateur crée un fichier d'en-tête précompilé contenant des informations de débogage. Une erreur peut se produire quand vous stockez l'en-tête précompilé dans une bibliothèque, que vous utilisez la bibliothèque pour générer un module objet et que le code source ne fait référence à aucune des fonctions définies dans le fichier d'en-tête précompilé.

Pour résoudre le problème, spécifiez /Ylsymbol (où symbol est le nom d'un symbole arbitraire dans la bibliothèque) lorsque vous créez un fichier d'en-tête précompilé qui ne contient aucune définition de fonction. Cette option indique au compilateur de stocker les informations de débogage dans le fichier d'en-tête précompilé.

Pour plus d'informations sur les en-têtes précompilés, consultez :

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d'informations, consultez Comment : ouvrir les pages de propriétés d'un projet.

  2. Cliquez sur le dossier C/C++.

  3. Cliquez sur la page de propriétés Ligne de commande.

  4. Spécifiez l'option du compilateur dans la zone Options supplémentaires.

Pour définir cette option du compilateur par programmation

Voir aussi

Référence

Options du compilateur

Définition des options du compilateur