Función SslGetKeyProperty

La función SslGetKeyProperty recupera el valor de una propiedad con nombre para un objeto de clave de proveedor del protocolo Secure Sockets Layer (SSL).

Sintaxis

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

Parámetros

hKey [in]

Identificador del proveedor SSL.

pszProperty [in]

Puntero a una cadena Unicode terminada en null que contiene el nombre de la propiedad que se va a recuperar. Puede ser uno de los identificadores predefinidos de propiedad de almacenamiento de claves o un identificador de propiedad personalizado.

ppbOutput [out]

Puntero a un búfer que recibe el valor de la propiedad. El autor de la llamada de la función debe liberar este búfer llamando a la función SslFreeBuffer .

pcbOutput [out]

Tamaño, en bytes, del búfer pbOutput .

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_INVALID_HANDLE 0x80090026L	Uno de los identificadores proporcionados no es válido.
NTE_INVALID_PARAMETER 0x80090027L	Uno de los parámetros proporcionados 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