Função SslCreateClientAuthHash
A função SslCreateClientAuthHash recupera um identificador para o hash handshake usado para autenticação do cliente.
Sintaxe
SECURITY_STATUS WINAPI SslCreateClientAuthHash(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
_In_ DWORD dwProtocol,
_In_ DWORD dwCipherSuite,
_In_ LPCWSTR pszHashAlgId,
_In_ DWORD dwFlags
);
Parâmetros
-
hSslProvider [in]
-
O identificador da instância do provedor de protocolo SSL ( Secure Sockets Layer ).
-
phHandshakeHash [out]
-
Um ponteiro para uma variável NCRYPT_HASH_HANDLE para receber o identificador de hash.
-
dwProtocol [in]
-
Um dos valores do Identificador de Protocolo do Provedor de SSL do CNG .
-
dwCipherSuite [in]
-
Um dos valores do Identificador do Pacote de Criptografia do Provedor de SSL do CNG .
-
pszHashAlgId [in]
-
Um dos valores de Identificadores de Algoritmo CNG .
-
dwFlags [in]
-
Esse parâmetro é reservado para uso futuro e deve ser definido como zero.
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 |
|---|---|
|
O parâmetro hSslProvider contém um ponteiro que não é válido. |
|
O parâmetro phHandshakeHash é definido como NULL. |
|
Não há suporte para a função selecionada na versão especificada da interface. |
|
Memória insuficiente para alocar buffers. |
|
O parâmetro dwFlags deve ser definido como zero. |
Comentários
A função SslCreateClientAuthHash é chamada para conversas TLS ( protocolo TLS) 1.2 ou posteriores para criar objetos de hash usados para mensagens de handshake de hash. Ele é chamado uma vez para cada algoritmo de hash possível que pode ser usado na assinatura de autenticação do cliente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|