Función SslOpenPrivateKey

La función SslOpenPrivateKey abre un identificador para 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 [ En]

Identificador de la instancia del proveedor Capa de sockets seguros protocolo ssl (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 llamando a la función SslFreeObject.

pCertContext [ En]

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

dwFlags [ En]

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.

Los códigos de retorno posibles 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 _ IDENTIFICADOR _ NO VÁLIDO
0x80090026L
El identificador hSslProvider no es válido.
NTE _ PARÁMETRO _ NO VÁLIDO
0x80090027L
El parámetro phPrivateKey o pCertContext es NULL.

Observaciones

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 Solo [ aplicaciones de escritorio de Vista]
Servidor mínimo compatible
Windows Solo aplicaciones de escritorio de Server 2008 []
Encabezado
Sslprovider.h
Archivo DLL
Ncrypt.dll