Función SslOpenPrivateKey

  • Artículo

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