/Yl (デバッグ ライブラリの PCH 参照の挿入)
プリコンパイル済みヘッダーを使用するデバッグ ライブラリの作成時にビルドが失敗する場合に使用されます。
/Ylsymbol
/Yl-
引数
symbol
オブジェクト モジュールに格納する任意のシンボル。-
明示的に /Yl のコンパイラ オプションを無効にすること （記号 （-）。
解説
既定では、 /Yl オプションが使用されます。 シンボルを指定せずに）。/Yl オプションは、型に関する完全な情報を取得するために、デバッガーができます。/Yl- は 既定の動作を無効にします。
/Yc と /Ylsymbol を指定してモジュールをコンパイルすると、コンパイラによって __@@_PchSym_@00@...@symbol のようなシンボルが作成されます。省略記号 (...) はリンカーによって生成される文字列です。このシンボルはオブジェクト モジュールに格納されます。このプリコンパイル済みヘッダーを使用してコンパイルするソース ファイルは、指定したシンボルを参照します。このため、リンカーによりオブジェクト モジュールとライブラリからのデバッグ情報が組み込まれます。
このオプションを使用すると、LNK1211 が発生することがあります。/Yc (プリコンパイル済みヘッダー ファイルの作成) オプションと /Z7、/Zi、/ZI (デバッグ情報の形式) オプションを指定すると、デバッグ情報が含まれたプリコンパイル済みヘッダー ファイルが作成されます。プリコンパイル済みヘッダーをライブラリに格納し、ライブラリを使用してオブジェクト モジュールを構築するときに、ソース コードがプリコンパイル済みヘッダー ファイルに定義された関数を 1 つも参照しないと、エラーが起こります。
関数定義が含まれていないプリコンパイル済みヘッダー ファイルを作成するときに、/Ylsymbol を指定すると、問題を解決できます。ただし、symbol はライブラリ内の任意のシンボルの名前です。このオプションは、デバッグ情報をプリコンパイル済みヘッダー情報に格納するようにコンパイラに指示します。
プリコンパイル済みヘッダーの詳細については、以下のトピックを参照してください。
Visual Studio 開発環境でこのコンパイラ オプションを設定するには
プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。詳細については、「方法 : プロジェクト プロパティ ページを開く」を参照してください。
[C/C++] フォルダーをクリックします。
[コマンド ライン] プロパティ ページをクリックします。
[追加のオプション]ボックスにコンパイラ オプションを入力します。
このコンパイラ オプションをコードから設定するには
- AdditionalOptions を参照してください。