Udostępnij za pośrednictwem

/Yl (Wprowadź odnośnik PCH dla bibliotek debugowania)

  • Artykuł

Opcja /Yl generuje unikatowy symbol w prekompilowany plik nagłówka, a odwołanie do tego symbolu jest wstrzykiwane we wszystkich plikach obiektów, które używają prekompilowanego nagłówka.

Składnia

/Yl
/Ylname
/Yl-

Argumenty

name
Opcjonalna nazwa używana jako część unikatowego symbolu.

-
Kreska (-) jawnie wyłącza /Yl kompilatora.

Uwagi

Opcja /Yl kompilatora tworzy unikatową definicję symboli w wstępnie skompilowanego pliku nagłówka utworzonego przy użyciu opcji /Yc . Odwołania do tego symbolu są automatycznie wstrzykiwane we wszystkich plikach, które zawierają prekompilowany nagłówek przy użyciu /Yu opcji kompilatora. /Yl opcja jest domyślnie włączona, gdy /Yc jest używany do tworzenia wstępnie skompilowanego pliku nagłówka.

Opcja /Ylname służy do tworzenia rozpoznawalnego symbolu w prekompilowany plik nagłówka. Kompilator używa argumentu nazwy w ramach nazwy symbolu ozdobionego, który tworzy, podobnie jak __@@_PchSym_@00@...@name, gdzie wielokropek (...) reprezentuje unikatowy ciąg znaków wygenerowany przez kompilator. Jeśli argument nazwy zostanie pominięty, kompilator automatycznie wygeneruje nazwę symbolu. Zwykle nie trzeba znać nazwy symbolu. Jeśli jednak projekt używa więcej niż jednego prekompilowanego pliku nagłówka, opcja /Ylname może być przydatna do określenia, które pliki obiektów używają prekompilowanego nagłówka. Możesz użyć nazwy jako ciągu wyszukiwania, aby znaleźć odwołanie do symboli w pliku zrzutu.

/Yl — wyłącza domyślne zachowanie i nie umieszcza symbolu identyfikującego w pliku prekompilowanego nagłówka. Skompilowane pliki zawierające ten wstępnie skompilowany nagłówek nie otrzymują wspólnego odwołania do symboli.

Jeśli /Yc nie jest określony, żadna /Yl opcja nie ma wpływu, ale jeśli określono, musi być zgodna z dowolną /Yl opcja przekazana, gdy /Yc jest określony.

Jeśli używasz opcji /Yl-, /Yc i /Z7 do utworzenia wstępnie skompilowanego pliku nagłówka, informacje debugowania są przechowywane w pliku obiektu dla pliku źródłowego użytego do utworzenia prekompilowanego nagłówka, a nie oddzielnego pliku pdb. Jeśli ten plik obiektu jest następnie częścią biblioteki, LNK1211 błędy lub ostrzeżenia LNK4206 mogą wystąpić w kompilacjach korzystających z tej biblioteki i wstępnie skompilowanego pliku nagłówka, jeśli plik źródłowy użyty do utworzenia wstępnie skompilowanego pliku nagłówka nie definiuje żadnych symboli. Konsolidator może wykluczyć plik obiektu z linku wraz ze skojarzonymi informacjami debugowania, gdy nic w pliku obiektu nie zostanie odwołane w kliencie biblioteki. Aby rozwiązać ten problem, określ /Yl (lub usuń /Yl- opcja) podczas używania /Yc do utworzenia prekompilowanego pliku nagłówka. Dzięki temu plik obiektu z biblioteki zawierającej informacje debugowania są połączone w kompilacji.

Aby uzyskać więcej informacji na temat wstępnie skompilowanych nagłówków, zobacz:

Aby ustawić tę opcję kompilatora w środowisku programowania Visual Studio

  1. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać szczegółowe informacje, zobacz Set C++ compiler and build properties in Visual Studio (Ustawianie właściwości kompilatora języka C++ i kompilowania w programie Visual Studio).

  2. Wybierz stronę Właściwości>konfiguracji C/C++>Wiersza polecenia.

  3. Dodaj opcję kompilatora /Ylname w polu Dodatkowe opcje . Wybierz przycisk OK , aby zapisać zmiany.

Aby programowo ustawić tę opcję kompilatora

Zobacz też

Opcje kompilatora MSVC
Składnia wiersza polecenia kompilatora MSVC