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

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

Note

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

Sintaxe

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

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

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.

/ZH:SHA384
Use um hash SHA-384 para a soma de verificação.

/ZH:SHA512
Use um hash SHA-512 para a soma de verificação.

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

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

Note

Não /ZH:SHA384 há suporte para opções e /ZH:SHA512 opções para arquivos IFC (interface do módulo). Se você compilar módulos com uma dessas opções, o compilador emitirá o erro fatal C1029. Use /ZH:SHA_256 ou um algoritmo de hash menor ao compilar módulos C++.

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

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.

  1. Modifique a propriedade Opções adicionais para adicionar uma /ZH:MD5opção, /ZH:SHA1, /ZH:SHA_256/ZH:SHA384ou /ZH:SHA512 , e, em seguida, escolha OK.
  1. Modifique a propriedade Opções adicionais para adicionar uma opção ou /ZH:SHA_256 uma /ZH:MD5opção /ZH:SHA1e escolha OK.

Confira também

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

  • Last updated on