Funzione SslOpenPrivateKey

La funzione SslOpenPrivateKey apre un handle a una chiave privata.

Sintassi

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

Parametri

hSslProvider [in]

Handle per l'istanza del provider di protocollo SSL (Secure Sockets Layer Protocol).

phPrivateKey [out]

Indirizzo di un buffer in cui scrivere l'handle nella chiave privata.

Al termine dell'uso della chiave, è consigliabile liberare phPrivateKey chiamando la funzione SslFreeObject .

pCertContext [in]

Indirizzo del certificato da cui ottenere la chiave privata.

dwFlags [in]

Questo parametro è riservato per usi futuri.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, a titolo esemplificativo, quanto segue.

Codice/valore restituito Descrizione
NTE_NO_MEMORY
0x8009000EL
Memoria insufficiente per allocare i buffer necessari.
NTE_INVALID_HANDLE
0x80090026L
L'handle hSslProvider non è valido.
NTE_INVALID_PARAMETER
0x80090027L
Il parametro phPrivateKey o pCertContext è NULL.

Commenti

La chiave privata ottenuta fa parte di una coppia di chiavi pubblica/privata all'interno di un certificato. Questa funzione estrae semplicemente la chiave privata dal certificato specificato dal parametro pCertContext .

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]
Intestazione
Sslprovider.h
DLL
Ncrypt.dll