Función SslOpenPrivateKey

La función SslOpenPrivateKey abre un identificador en una clave privada.

Sintaxis

SECURITY_STATUS WINAPI SslOpenPrivateKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phPrivateKey,
  _In_  PCCERT_CONTEXT     pCertContext,
  _In_  DWORD              dwFlags
);

Parámetros

hSslProvider [in]

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

phPrivateKey [out]

Dirección de un búfer en el que se va a escribir el identificador en la clave privada.

Cuando haya terminado de usar la clave, debe liberar phPrivateKey mediante una llamada a la función SslFreeObject .

pCertContext [in]

Dirección del certificado desde el que se va a obtener la clave privada.

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_NO_MEMORY 0x8009000EL	No hay suficiente memoria disponible para asignar los búferes necesarios.
NTE_INVALID_HANDLE 0x80090026L	El identificador hSslProvider no es válido.
NTE_INVALID_PARAMETER 0x80090027L	El parámetro phPrivateKey o pCertContext es NULL.

Comentarios

La clave privada obtenida forma parte de un par de claves pública y privada dentro de un certificado. Esta función simplemente extrae la clave privada del certificado especificado por el parámetro pCertContext .

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