/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.

Note

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

Sintaxe

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

/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 e SHA-256. Devido ao risco de problemas de colisão em MD5 e SHA-1, use a /ZH:SHA_256 opção ou mais forte.

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. Devido ao risco de problemas de colisão em MD5 e SHA-1, utilize-se a /ZH:SHA_256 opção ou um algoritmo mais forte. O SHA-384 e o SHA-512 fornecem somas de verificação mais fortes, mas podem aumentar o tempo de compilação.

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.

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 .

  1. 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.
  1. Modifique a propriedade Opções Adicionais para adicionar um /ZH:MD5, /ZH:SHA1, ou /ZH:SHA_256 opção, e depois escolha OK.

Ver também

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