Função SslComputeClientAuthHash
A função SslComputeClientAuthHash calcula um hash a ser usado durante a autenticação do certificado .
Sintaxe
SECURITY_STATUS WINAPI SslComputeClientAuthHash(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ NCRYPT_KEY_HANDLE hMasterKey,
_In_ NCRYPT_HASH_HANDLE hHandshakeHash,
_In_ LPCWSTR pszAlgId,
_Out_ PBYTE pbOutput,
_In_ DWORD cbOutput,
_Out_ DWORD *pcbResult,
_In_ DWORD dwFlags
);
Parâmetros
-
hSslProvider [in]
-
O identificador da instância do provedor de protocolo SSL ( Secure Sockets Layer ).
-
hMasterKey [in]
-
O identificador do objeto de chave master.
-
hHandshakeHash [in]
-
O identificador do hash do handshake calculado até agora.
-
pszAlgId [in]
-
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que identifica o algoritmo criptográfico solicitado. Esse pode ser um dos Identificadores de Algoritmo CNG padrão ou o identificador de outro algoritmo registrado.
-
pbOutput [out]
-
O endereço de um buffer que recebe a chave BLOB. O parâmetro cbOutput contém o tamanho desse buffer. Se esse parâmetro for NULL, essa função colocará o tamanho necessário, em bytes, no DWORD apontado pelo parâmetro pcbResult .
-
cbOutput [in]
-
O comprimento, em bytes, do buffer pbOutput .
-
pcbResult [out]
-
Um ponteiro para um valor DWORD que especifica o comprimento, em bytes, do hash gravado no buffer pbOutput .
-
dwFlags [in]
-
Esse parâmetro é reservado para uso futuro.
Valor retornado
Se a função for bem-sucedida, ela retornará zero.
Se a função falhar, ela retornará um valor de erro diferente de zero.
Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.
| Retornar código/valor | Descrição |
|---|---|
|
Um dos identificadores fornecidos não é válido. |
Comentários
A função SslComputeClientAuthHash calcula o hash enviado na mensagem de verificação de certificado do handshake SSL. O valor de hash é calculado criando um hash que contém o segredo master com um hash de todas as mensagens de handshake anteriores enviadas ou recebidas.
A maneira como o hash é calculado depende do protocolo e do conjunto de criptografias usados. Além disso, o hash depende do tipo de chave de autenticação do cliente usada; o parâmetro pszAlgId indica o tipo de chave usada para autenticação do cliente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|