/ZH (Hashalgorithmus für die Berechnung der Dateiüberprüfung in Debuginformationen)

Gibt an, welcher kryptografische Hashalgorithmus zum Generieren einer Prüfsumme jeder Quelldatei verwendet werden soll.

Note

Die /ZH Option ist in Visual Studio 2019, Version 16.4 und höher, verfügbar.

Syntax

/ZH:MD5
/ZH:SHA1
/ZH:SHA_256

/ZH:MD5
/ZH:SHA1
/ZH:SHA_256
/ZH:SHA384
/ZH:SHA512

Argumente

/ZH:MD5
Verwenden Sie einen MD5-Hash für die Prüfsumme. Diese Option ist die Standardeinstellung in Visual Studio 2019.

/ZH:SHA1
Verwenden Sie einen SHA-1-Hash für die Prüfsumme.

/ZH:SHA_256
Verwenden Sie einen SHA-256-Hash für die Prüfsumme. Diese Option ist die Standardeinstellung in Visual Studio 2022, Version 17.0 und höher.

/ZH:SHA384
Verwenden Sie einen SHA-384-Hash für die Prüfsumme.

/ZH:SHA512
Verwenden Sie einen SHA-512-Hash für die Prüfsumme.

Hinweise

PDB-Dateien speichern eine Prüfsumme für jede Quelldatei, die in den Objektcode in der zugehörigen ausführbaren Datei kompiliert wird. Mit der Prüfsumme kann der Debugger überprüfen, ob der geladene Quellcode mit der ausführbaren Datei übereinstimmt. Der Compiler und Debugger unterstützen MD5-, SHA-1- und SHA-256-Hashalgorithmen. Aufgrund eines Risikos von Kollisionsproblemen in MD5 und SHA-1 verwenden Sie die /ZH:SHA_256 Option oder stärker.

PDB-Dateien speichern eine Prüfsumme für jede Quelldatei, die in den Objektcode in der zugehörigen ausführbaren Datei kompiliert wird. Mit der Prüfsumme kann der Debugger überprüfen, ob der geladene Quellcode mit der ausführbaren Datei übereinstimmt. Der Compiler und Debugger unterstützen MD5-, SHA-1-, SHA-256-, SHA-384- und SHA-512-Hashalgorithmen. Verwenden Sie aufgrund eines Risikos von Kollisionsproblemen in MD5 und SHA-1 die /ZH:SHA_256 Option oder einen stärkeren Algorithmus. SHA-384 und SHA-512 bieten stärkere Prüfsummen, können jedoch die Kompilierungszeit erhöhen.

Note

Die /ZH:SHA384 Optionen werden /ZH:SHA512 für IFC-Dateien (Modulschnittstelle) nicht unterstützt. Wenn Sie Module mit einer dieser Optionen kompilieren, gibt der Compiler einen schwerwiegenden Fehler C1029 aus. Verwenden Sie /ZH:SHA_256 beim Kompilieren von C++-Modulen einen kleineren Hashalgorithmus oder einen kleineren Hashalgorithmus.

Wenn mehrere /ZH Optionen angegeben werden, wird die letzte Option verwendet.

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Öffnen Sie das Dialogfeld Eigenschaftenseiten für das Projekt. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  2. Legen Sie die Dropdownliste "Konfiguration " auf " Alle Konfigurationen" fest. Wählen Sie in der Dropdownliste Plattform die Option Alle Plattformen aus.

  3. Klicken Sie auf der Eigenschaftenseite auf Konfigurationseigenschaften>C/C++>Befehlszeile.

  1. Ändern Sie die Eigenschaft "Zusätzliche Optionen", um ein /ZH:MD5, /ZH:SHA1/ZH:SHA_256/ZH:SHA384oder /ZH:SHA512 eine Option hinzuzufügen, und wählen Sie dann "OK" aus.
  1. Ändern Sie die Eigenschaft "Zusätzliche Optionen", um eine /ZH:MD5oder /ZH:SHA1/ZH:SHA_256 eine Option hinzuzufügen, und wählen Sie dann "OK" aus.

Siehe auch

Compileroptionen
Debug Interface Access SDK - IDiaSourceFile::get_checksumType
Quellserver