/ZH (Хэш-алгоритм для вычисления контрольной суммы файлов в отладочной информации)

Указывает, какой алгоритм криптографического хэша используется для создания контрольной суммы каждого исходного файла.

Синтаксис

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

Аргументы

/ZH:MD5
Используйте хэш MD5 для контрольной суммы. Этот параметр используется по умолчанию в Visual Studio 2019.

/ZH:SHA1
Используйте хэш SHA-1 для контрольной суммы.

/ZH:SHA_256
Используйте хэш SHA-256 для контрольной суммы. Этот параметр используется по умолчанию в Visual Studio 2022 версии 17.0 и более поздних версиях.

/ZH:SHA384
Используйте хэш SHA-384 для контрольной суммы.

/ZH:SHA512
Используйте хэш SHA-512 для контрольной суммы.

Замечания

PDB-файлы хранят контрольную сумму для каждого исходного файла, скомпилированного в код объекта в связанном исполняемом файле. Контрольная сумма позволяет отладчику проверить, соответствует ли исходный код исполняемому файлу. Компилятор и отладчик поддерживают хэш-алгоритмы MD5, SHA-1, SHA-256, SHA-384 и SHA-512. По умолчанию в Visual Studio 2019 компилятор использует хэш MD5 для создания контрольной суммы. Чтобы явно указать этот хэш-алгоритм, используйте /ZH:MD5 этот параметр.

Из-за риска конфликтов в MD5 и SHA-1 используйте вариант или более сильный /ZH:SHA_256 . Параметры SHA-384 и SHA-512 обеспечивают более строгие контрольные суммы, но могут увеличить время компиляции. Параметр /ZH:SHA_256 по умолчанию используется в Visual Studio 2022 версии 17.0 и более поздних версиях.

Note

Параметры /ZH:SHA384 и /ZH:SHA512 параметры не поддерживаются для файлов IFC (интерфейс модуля). Если вы компилируете модули с одним из этих параметров, компилятор выдает неустранимая ошибка C1029. При /ZH:SHA_256 компиляции модулей C++ используется или используется меньший хэш-алгоритм.

При указании нескольких /ZH вариантов используется последний параметр.

Этот /ZH параметр доступен в Visual Studio 2019 версии 16.4 и более поздних версий.

Установка данного параметра компилятора в среде разработки Visual Studio

1. Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.

2. Установите раскрывающийся список "Конфигурация" для всех конфигураций. В раскрывающемся списке Платформа выберите пункт Все платформы.

3. Перейдите на страницу свойств Свойства конфигурации>C/C++>Командная строка.

4. Измените свойство "Дополнительные параметры", чтобы добавить /ZH:MD5параметр , /ZH:SHA1/ZH:SHA384/ZH:SHA_256или /ZH:SHA512 параметр, а затем нажмите кнопку "ОК".

См. также

Параметры компилятора
Пакет SDK для доступа к интерфейсу отладки — IDiaSourceFile::get_checksumType
Исходный сервер