Función SslCreateClientAuthHash

La función SslCreateClientAuthHash recupera un identificador al hash de protocolo de enlace que se usa para la autenticación de cliente.

Sintaxis

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]

Identificador de la instancia del proveedor del protocolo Capa de sockets seguros (SSL).

phHandshakeHash [out]

Puntero a una variable de NCRYPT_HASH_HANDLE para recibir el identificador hash.

dwProtocol [in]

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

dwCipherSuite [in]

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

pszHashAlgId [in]

Uno de los valores de identificadores de algoritmo de CNG .

dwFlags [in]

Este parámetro está reservado para uso futuro y debe establecerse en cero.

Valor devuelto

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

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

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

Código o valor devuelto	Descripción
NTE_INVALID_HANDLE 0x80090026L	El parámetro hSslProvider contiene un puntero que no es válido.
NTE_INVALID_PARAMETER 0x80090027L	El parámetro phHandshakeHash se establece en NULL.
NTE_NOT_SUPPORTED 0x80090029L	La función seleccionada no se admite en la versión especificada de la interfaz.
NTE_NO_MEMORY 0x8009000EL	Memoria insuficiente para asignar búferes.
NTE_BAD_FLAGS 0x80090009L	El parámetro dwFlags debe establecerse en cero.

Comentarios

Se llama a la función SslCreateClientAuthHash para las conversaciones del protocolo de seguridad de la capa de transporte (TLS) 1.2 o posterior para crear objetos hash que se usan para aplicar hash a los mensajes de protocolo de enlace. Se llama una vez para cada posible algoritmo hash que se puede usar en la firma de autenticación de cliente.

Requisitos

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