/ZH (Algoritmo de hash para cálculo da soma de verificação de arquivo em informações de depuração)

  • Artigo

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

Sintaxe

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

Argumentos

/ZH:MD5
Usar um hash MD5 para a soma de verificação. Essa opção é o padrão no Visual Studio 2019.

/ZH:SHA1
Usar um hash SHA-1 para a soma de verificação.

/ZH:SHA_256
Usar um hash SHA-256 para a soma de verificação. Essa opção é o padrão no Visual Studio 2022 versão 17.0 e posterior.

Comentários

Os arquivos PDB armazenam uma soma de verificação para cada arquivo de origem, compilado no código do objeto no executável associado. A soma de verificação permite que o depurador verifique se o código-fonte carregado corresponde ao executável. O compilador e o depurador dão suporte a algoritmos de hash MD5, SHA-1 e SHA-256. Por padrão, no Visual Studio 2019, o compilador usa um hash MD5 para gerar a soma de verificação. Para especificar esse algoritmo de hash de maneira explícita, use a opção /ZH:MD5.

Devido ao risco de problemas de colisão no MD5 e SHA-1, a Microsoft recomenda que você use a opção /ZH:SHA_256. O hash SHA-256 pode resultar em um pequeno aumento nos tempos de compilação. A opção /ZH:SHA_256 é o padrão no Visual Studio 2022 versão 17.0 e posterior.

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

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

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

  1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  2. Defina o menu suspenso Configuração como Todas as Configurações. Defina a lista suspensa Plataforma como Todas as plataformas.

  3. Selecione a página de propriedades Propriedades de Configuração>C/C++>Linha de Comando.

  4. Modifique a propriedade Opções adicionais para incluir uma opção /ZH:MD5, /ZH:SHA1 ou /ZH:SHA_256e escolha OK.

Confira também

Opções do compilador
Servidor de origem