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