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 |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um erforderliche Puffer zu reservieren. |
|
Das hSslProvider-Handle ist ungültig. |
|
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 |
|
| DLL |
|