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 |
|---|---|
|
Não há memória suficiente para alocar o buffer de hash. |
|
O identificador hSslProvider não é válido. |
|
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.
- A função SslCreateHandshakeHash é chamada para obter um identificador de hash.
- A função SslHashHandshake é chamada várias vezes com o identificador de hash para adicionar dados ao hash.
- 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 |
|
| DLL |
|