Función SslGetCipherSuitePRFHashAlgorithm

La función SslGetCipherSuitePRFHashAlgorithm devuelve cryptography API: Next Generation (CNG) Algorithm Identifier del algoritmo hash que se usa para la función pseudoaleatoria del protocolo de seguridad de la capa de transporte (TLS) para el protocolo de entrada, el conjunto de cifrado y el tipo de clave.

Sintaxis

SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwKeyType,
  _Out_ WCHAR              szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
  _In_  DWORD              dwFlags
);

Parámetros

hSslProvider [in]

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

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 .

dwKeyType [in]

Uno de los valores del identificador de tipo de clave del proveedor SSL de CNG . Para los tipos de clave que no son criptografía de curva elíptica (ECC), establezca este parámetro en cero.

szPRFHash [out]

Uno de los identificadores de algoritmo de CNG para el hash que se usará para el PRF de TLS.

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 szPRFHash se establece en NULL.
NTE_NOT_SUPPORTED 0x80090029L	La función seleccionada no se admite en la versión especificada de la interfaz.
NTE_BAD_FLAGS 0x80090009L	El parámetro dwFlags debe establecerse en cero.

Comentarios

Se llama a esta función SslGetCipherSuitePRFHashAlgorithm para las conversaciones TLS 1.2 o posteriores para consultar el algoritmo hash que se usará en el PRF de TLS.

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