SslImportKey-Funktion

Die SslImportKey-Funktion importiert einen Schlüssel in den Secure Sockets Layer-Protokollanbieter (SSL).

Syntax

SECURITY_STATUS WINAPI SslImportKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phKey,
  _In_  LPCWSTR            pszBlobType,
  _In_  PBYTE              pbKeyBlob,
  _In_  DWORD              cbKeyBlob,
  _In_  DWORD              dwFlags
);

Parameter

hSslProvider [ In]

Das Handle für die SSL-Protokollanbieterinstanz.

phKey [ out]

Ein Zeiger auf das Handle des kryptografischen Schlüssels, um den importierten Schlüssel zu empfangen.

pszBlobType [ In]

Eine auf NULL terminierte Unicode-Zeichenfolge, die einen Bezeichner enthält, der den Blobtyp angibt, der im pbInput-Puffer enthalten ist. Dies kann einer der folgenden Werte sein.

Wert Bedeutung
ÖFFENTLICHES BCRYPT _ _ _ DH-BLOB
Exportieren Sie Diffie-Hellman öffentlichen Schlüssel. Der pbOutput-Puffer empfängt eine BCRYPT _ DH KEY _ _ BLOB-Struktur unmittelbar gefolgt von den Schlüsseldaten.
BCRYPT _ _ ECCPUBLIC-BLOB
Exportieren Sie einen öffentlichen ECC-Schlüssel (Elliptic Curve Cryptography). Der pbOutput-Puffer empfängt eine BCRYPT _ ECLEKY-BLOB-Struktur _ unmittelbar gefolgt von den Schlüsseldaten.
BLOB MIT _ NICHT TRANSPARENTEM BCRYPT-SCHLÜSSEL _ _
Exportieren Sie einen symmetrischen Schlüssel in einem Format, das für einen einzelnen Kryptografiedienstanbieter (Cryptographic Service Provider, CSP) spezifisch ist. Nicht transparente BLOBs sind nicht übertragbar und müssen mit demselben CSP importiert werden, der das BLOB generiert hat.
BCRYPT _ _ RSAPUBLIC-BLOB
Exportieren sie einen öffentlichen RSA-Schlüssel. Der pbOutput-Puffer empfängt eine BCRYPT _ _ RSAKEY-BLOB-Struktur unmittelbar gefolgt von den Schlüsseldaten.

pbKeyBlob [ In]

Ein Zeiger auf den Puffer, der den Schlüssel BLOB enthält.

cbKeyBlob [ In]

Die Größe des pbKeyBlob-Puffers in Bytes.

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 erforderliche Puffer zu reservieren.
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Das hSslProvider-Handle ist ungültig.
NTE _ UNGÜLTIGER _ PARAMETER
0x80090027L
Der phKey-Parameter ist NULL.

Hinweise

Sie können die SslImportKey-Funktion verwenden, um Sitzungsschlüssel als Teil des Prozesses zum Übertragen von Sitzungsschlüsseln von einem Prozess in einen anderen zu importieren.

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