Función SslLookupCipherLengths

La función SslLookupCipherLengths devuelve una estructura NCRYPT_SSL_CIPHER_LENGTHS que contiene las longitudes de encabezado y finalizador del protocolo de entrada, el conjunto de cifrado y el tipo de clave.

Sintaxis

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _In_  DWORD                     dwFlags
);

Parámetros

hSslProvider [in]

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

dwProtocol [in]

Uno de los valores del 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 de identificador de tipo de clave de 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.

pCipherLengths [out]

Puntero a un búfer para recibir la estructura NCRYPT_SSL_CIPHER_LENGTHS .

cbCipherLengths [in]

Longitud, en bytes, del búfer al que apunta el parámetro pCipherLengths .

dwFlags [in]

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

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_INVALID_HANDLE 0x80090026L	El parámetro hSslProvider contiene un puntero que no es válido.
NTE_INVALID_PARAMETER 0x80090027L	El parámetro pCipherLengths se establece en NULL o la longitud del búfer especificada por cbCipherLengths es demasiado corta.
NTE_BAD_FLAGS 0x80090009L	El parámetro dwFlags debe establecerse en cero.

Comentarios

Se llama a la función SslLookupCipherLengths para las conversaciones del protocolo de seguridad de la capa de transporte (TLS) 1.1 o posterior para consultar las longitudes de encabezado y finalizador para el protocolo solicitado, el conjunto de cifrado y el tipo de clave.

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