Função SslCreateHandshakeHash

A função SslCreateHandshakeHash obtém um identificador de hash usado para mensagens de handshake de hash.

Sintaxe

SECURITY_STATUS WINAPI SslCreateHandshakeHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwFlags
);

Parâmetros

hSslProvider [in]

O identificador da instância do provedor de protocolo SSL .

phHandshakeHash [out]

Um identificador de hash que pode ser passado para outras funções de provedor SSL.

dwProtocol [in]

Um dos valores do Identificador de Protocolo do Provedor SSL do CNG .

Observação

Essa função não é usada com o protocolo SSL 2.0.

dwCipherSuite [in]

Um dos valores do Identificador do Pacote de Criptografia do Provedor de SSL do CNG .

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.

Código/valor de retorno	Descrição
NTE_NO_MEMORY 0x8009000EL	Não há memória suficiente para alocar o buffer de hash.
NTE_INVALID_HANDLE 0x80090026L	O identificador hSslProvider não é válido.
NTE_INVALID_PARAMETER 0x80090027L	O phHandshakeHash é nulo.

Comentários

A função SslCreateHandshakeHash é uma das três funções usadas para gerar um hash a ser usado durante o handshake SSL.

1. A função SslCreateHandshakeHash é chamada para obter um identificador de hash.
2. A função SslHashHandshake é chamada várias vezes com o identificador de hash para adicionar dados ao hash.
3. A função SslComputeFinishedHash é chamada com o identificador de hash para obter o resumo dos dados com hash.

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	Sslprovider.h
DLL	Ncrypt.dll