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
NTE _ NO _ MEMORY
0x8009000EL
Es ist nicht genügend Arbeitsspeicher verfügbar, um die erforderlichen Puffer zuzuordnen.
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Das hSslProvider-Handle ist ungültig.
NTE _ INVALID _ PARAMETER
0x80090027L
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
Sslprovider.h
DLL
Ncrypt.dll