/ZH (デバッグ情報でのファイル チェックサムの計算に使用するハッシュ アルゴリズム)
各ソース ファイルのチェックサムの生成に使用する暗号ハッシュ アルゴリズムを指定します。
構文
/ZH:MD5
/ZH:SHA1
/ZH:SHA_256
引数
/ZH:MD5
チェックサムに MD5 ハッシュを使用します。 これは、Visual Studio 2019 での既定のオプションです。
/ZH:SHA1
チェックサムに SHA-1 ハッシュを使用します。
/ZH:SHA_256
チェックサムに SHA-256 ハッシュを使用します。 これは、Visual Studio 2022 バージョン 17.0 以降での既定のオプションです。
解説
PDB ファイルには、関連付けられた実行可能ファイル内のオブジェクト コードにコンパイルされた各ソース ファイルのチェックサムが格納されます。 チェックサムを使用することで、デバッガーは、読み込んだソース コードが実行可能ファイルと一致していることを確認できます。 コンパイラとデバッガーでは、MD5、SHA-1、および SHA-256 のハッシュ アルゴリズムがサポートされています。 Visual Studio 2019 では既定で、コンパイラによって MD5 ハッシュが使用され、チェックサムが生成されます。 このハッシュ アルゴリズムを明示的に指定するには、/ZH:MD5 オプションを使用します。
MD5 と SHA-1 での競合の問題のリスクがあるため、Microsoft では /ZH:SHA_256 オプションを使用することをお勧めします。 SHA-256 ハッシュを使用すると、コンパイル時間がわずかに増加することがあります。 /ZH:SHA_256 オプションは、Visual Studio 2022 バージョン 17.0 以降で使用できます。
複数の /ZH オプションが指定されている場合は、最後のオプションが使用されます。
/ZH オプションは、Visual Studio 2019 バージョン 16.4 以降で使用できます。
Visual Studio 開発環境でこのコンパイラ オプションを設定するには
プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、Visual Studio での C++ コンパイラとビルド プロパティの設定に関する記事を参照してください。
[構成] ドロップダウンを [すべての構成] に設定します。 [プラットフォーム] ドロップダウンを [すべてのプラットフォーム] に設定します。
[構成プロパティ]>[C/C++]>[コマンド ライン] プロパティ ページを選択します。
[追加オプション] プロパティを変更して、
/ZH:MD5、/ZH:SHA1または/ZH:SHA_256オプションを追加し、[OK] を選択します。