Método IEnroll::get_HashAlgorithmWStr (xenroll.h)
[Essa propriedade não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]
A propriedade HashAlgorithmWStr define ou recupera apenas o algoritmo de hash de assinatura usado para assinar a solicitação de certificação PKCS nº 10.
Essa propriedade foi definida pela primeira vez na interface IEnroll .
Essa propriedade é leitura/gravação.
Sintaxe
HRESULT get_HashAlgorithmWStr(
LPWSTR *szw
);
Parâmetros
szw
Valor retornado
Nenhum
Comentários
Esse algoritmo de hash de assinatura não deve ser confundido com o algoritmo de hash usado para assinar o certificado. Atualmente, o controle de registro dá suporte a qualquer OID para algoritmos de hash, além dos seguintes valores de nome de exibição: SHA1 (o padrão), MD2 e MD5. Ao recuperar essa propriedade, o valor recuperado está no formato OID (ou seja, SHA1 aparece como 1.3.14.3.2.29). Ao definir essa propriedade, o formato OID correspondente pode ser usado como uma alternativa ao texto mostrado para os valores amigáveis definidos.
O Controle de Registro de Certificado considera o valor da propriedade HashAlgorithmWStr como uma dica para o algoritmo de hash a ser usado para assinar a solicitação de certificação PKCS nº 10. Se o provedor de serviços criptográficos (CSP) der suporte ao algoritmo especificado na propriedade HashAlgorithmWStr , o algoritmo será usado. Caso contrário, o Controle de Registro de Certificado tentará usar SHA1. Se o SHA1 não tiver suporte do CSP, o MD5 será testado. Se não houver suporte para SHA1 nem MD5, o Controle de Registro de Certificado tentará usar o primeiro algoritmo de hash retornado do CSP.
A propriedade HashAlgorithmWStr afeta o comportamento dos seguintes métodos:
Se as propriedades HashAlgID e HashAlgorithmWStr estiverem definidas, o que for atualizado pela última vez especificará qual algoritmo de hash será usado para assinar a solicitação de certificação PKCS nº 10.
Requisitos
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | xenroll.h |
Biblioteca | Uuid.lib |
DLL | Xenroll.dll |