Función SslLookupCipherSuiteInfo

  • Artículo

La función SslLookupCipherSuiteInfo recupera la información del conjunto de cifrado de un protocolo, un conjunto de cifrado y un conjunto de tipos de clave especificados.

Sintaxis

SECURITY_STATUS WINAPI SslLookupCipherSuiteInfo(
  _In_  NCRYPT_PROV_HANDLE      hSslProvider,
  _In_  DWORD                   dwProtocol,
  _In_  DWORD                   dwCipherSuite,
  _In_  DWORD                   dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_SUITE *pCipherSuite,
  _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 de identificador de protocolo de proveedor SSL de CNG .

dwCipherSuite [in]

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

dwKeyType [in]

Uno de los valores de identificadores de tipo de clave del proveedor SSL de CNG .

pCipherSuite [out]

Dirección de un búfer que contiene una estructura NCRYPT_SSL_CIPHER_SUITE en la que se va a escribir la información del conjunto de cifrado.

dwFlags [in]

Este parámetro se reserva para uso futuro.

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 identificador hSslProvider no es válido.

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