Función SslCreateHandshakeHash

La función SslCreateHandshakeHash obtiene un identificador hash que se usa para aplicar un hash a los mensajes de protocolo de enlace.

Sintaxis

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]

Identificador de la instancia del proveedor del protocolo Secure Sockets Layer (SSL).

phHandshakeHash [out]

Identificador hash que se puede pasar a otras funciones del proveedor SSL.

dwProtocol [in]

Uno de los valores del identificador de protocolo de proveedor SSL de CNG .

Nota:

Esta función no se usa con el protocolo SSL 2.0.

dwCipherSuite [in]

Uno de los valores del identificador del conjunto de cifrado del proveedor SSL de CNG .

dwFlags [in]

Este parámetro se reserva para uso futuro.

Valor devuelto

Si la función se realiza correctamente, devuelve cero.

Si se produce un error en la función, devuelve un valor de error distinto de cero.

Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código o valor devuelto	Descripción
NTE_NO_MEMORY 0x8009000EL	No hay memoria suficiente para asignar el búfer hash.
NTE_INVALID_HANDLE 0x80090026L	El identificador hSslProvider no es válido.
NTE_INVALID_PARAMETER 0x80090027L	PhHandshakeHash es null.

Comentarios

La función SslCreateHandshakeHash es una de las tres funciones que se usan para generar un hash que se usará durante el protocolo de enlace SSL.

1. Se llama a la función SslCreateHandshakeHash para obtener un identificador hash.
2. La función SslHashHandshake se denomina cualquier número de veces con el identificador hash para agregar datos al hash.
3. Se llama a la función SslComputeFinishedHash con el identificador hash para obtener el resumen de los datos con hash.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Sslprovider.h
Archivo DLL	Ncrypt.dll