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 die SSL-Protokollanbieterinstanz (Secure Sockets Layer Protocol).
-
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, aus dem der private Schlüssel abzurufen ist.
-
dwFlags [ In]
-
Dieser Parameter ist für die zukünftige Verwendung reserviert.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie 0 (null) zurück.
Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich 0 (null) zurückgegeben.
Mögliche Rückgabecodes sind u. a. folgende.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um die erforderlichen Puffer zuzuordnen. |
|
Das hSslProvider-Handle ist ungültig. |
|
Der parameter phPrivateKey oder pCertContext ist NULL. |
Hinweise
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 [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| DLL |
|