SslOpenPrivateKey-Funktion
Die SslOpenPrivateKey-Funktion öffnet ein Handle für einen privaten Schlüssel.
Syntax
SECURITY_STATUS WINAPI SslOpenPrivateKey(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_KEY_HANDLE *phPrivateKey,
_In_ PCCERT_CONTEXT pCertContext,
_In_ DWORD dwFlags
);
Parameter
-
hSslProvider [in]
-
Das Handle für den SSL-Protokollanbieter (Secure Sockets Layer Protocol) instance.
-
phPrivateKey [out]
-
Die Adresse eines Puffers, in den das Handle in den privaten Schlüssel geschrieben werden soll.
Wenn Sie die Verwendung des Schlüssels abgeschlossen haben, sollten Sie phPrivateKey freigeben, indem Sie die SslFreeObject-Funktion aufrufen.
-
pCertContext [in]
-
Die Adresse des Zertifikats, von dem der private Schlüssel abgerufen werden soll.
-
dwFlags [in]
-
Dieser Parameter ist für die zukünftige Verwendung reserviert.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie null zurück.
Wenn die Funktion fehlschlägt, gibt sie einen fehlerfreien Wert zurück.
Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Für die Zuweisung der erforderlichen Puffer steht nicht genügend Arbeitsspeicher zur Verfügung. |
|
Das hSslProvider-Handle ist ungültig. |
|
Der parameter phPrivateKey oder pCertContext ist NULL. |
Bemerkungen
Der abgerufene private Schlüssel ist Teil eines öffentlichen/privaten Schlüsselpaars innerhalb eines Zertifikats. Diese Funktion extrahiert lediglich den privaten Schlüssel aus dem durch den pCertContext-Parameter angegebenen Zertifikat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| DLL |
|