/ZH (Algoritmo de hash para cálculo do checksum de ficheiros na informação de depuração)

Especifica qual algoritmo de hash criptográfico usar para gerar uma soma de verificação de cada ficheiro fonte.

Sintaxe

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

Arguments

/ZH:MD5
Use um hash MD5 para o checksum. Esta opção é a predefinida no Visual Studio 2019.

/ZH:SHA1
Use um hash SHA-1 para o checksum.

/ZH:SHA_256
Use um hash SHA-256 para o checksum. Esta opção é a predefinida no Visual Studio 2022 versão 17.0 e posteriores.

/ZH:SHA384
Use um hash SHA-384 para o checksum.

/ZH:SHA512
Use um hash SHA-512 para o checksum.

Remarks

Os ficheiros PDB armazenam uma soma de verificação para cada ficheiro fonte, compilada no código objeto no executável associado. O checksum permite ao depurador verificar se o código-fonte que carrega corresponde ao executável. O compilador e o depurador suportam algoritmos de hash MD5, SHA-1, SHA-256, SHA-384 e SHA-512. Por defeito, no Visual Studio 2019 o compilador usa um hash MD5 para gerar o checksum. Para especificar explicitamente este algoritmo de hash, use a /ZH:MD5 opção.

Devido ao risco de problemas de colisão em MD5 e SHA-1, use a /ZH:SHA_256 opção ou mais forte. As opções SHA-384 e SHA-512 fornecem somas de verificação mais fortes, mas podem aumentar o tempo de compilação. A opção /ZH:SHA_256 é a predefinida em Visual Studio versão 17.0 de 2022 e posteriores.

Note

As /ZH:SHA384 opções e /ZH:SHA512 não são suportadas para ficheiros IFC (interface de módulo). Se compilar módulos com uma destas opções, o compilador emite o erro fatal C1029. Use /ZH:SHA_256 um algoritmo de hash mais pequeno quando compilar módulos em C++.

Quando mais do que uma /ZH opção é especificada, é usada a última opção.

A opção /ZH está disponível em Visual Studio versão 16.4 de 2019 e posteriores.

Para definir esta opção de compilador no ambiente de desenvolvimento Visual Studio

  1. Abra a caixa de diálogo Property Pages para o projeto. Para mais detalhes, consulte o compilador C++ Set e propriedades de construção em Visual Studio.

  2. Defina o menu suspenso Configuração para Todas as Configurações. Defina o seletor Plataforma como Todas as plataformas.

  3. Selecione a página de propriedades Configuration Properties>C/C++>Command Line .

  4. Modifica a propriedade de opções adicionais para adicionar , /ZH:MD5/ZH:SHA1, /ZH:SHA_256, /ZH:SHA384, ou /ZH:SHA512 opção, e depois escolhe OK.

Ver também

Opções do compilador
SDK de Acesso à Interface de Depuração - IDiaSourceFile::get_checksumType
Servidor de origem

  • Last updated on