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 |
|---|---|
|
Memoria insufficiente per allocare i buffer necessari. |
|
L'handle hSslProvider non è valido. |
|
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 |
|
| DLL |
|