IX509PrivateKey::Import-Methode (certenroll.h)

Artikel
02/23/2024

Die Import-Methode importiert einen vorhandenen privaten Schlüssel in einen Schlüsselcontainer innerhalb eines Kryptografieanbieters.

Syntax

HRESULT Import(
  [in] BSTR         strExportType,
  [in] BSTR         strEncodedKey,
  [in] EncodingType Encoding
);

Parameter

[in] strExportType

Wenn der Schlüssel mithilfe eines CNG-KSP (Key Storage Provider) erstellt wurde, übergibt die Import-Methode dieses Argument an den pszProperty-Parameter der NCryptSetProperty-Funktion . Das heißt, der von Ihnen angegebene Wert wird als Name einer Eigenschaft verwendet, die für den importierten Schlüssel festgelegt werden soll.

Wenn der Schlüssel mit einem CryptoAPI-CSP (Kryptografiedienstanbieter) erstellt wurde, gibt dieses Argument an, wie der private Schlüssel importiert werden soll. Dies kann der folgende Wert sein.

Wert	Bedeutung
BCRYPT_PRIVATE_KEY_BLOB	Importiert den gesamten privaten Schlüssel.

[in] strEncodedKey

Eine BSTR-Variable , die den zu importierenden Schlüssel enthält.

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, der auf die im strEncodedKey-Parameter enthaltene Zeichenfolge angewendet werden soll. Der Standardwert ist XCN_CRYPT_STRING_BASE64.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32(ERROR_FILE_READ_ONLY)	Der Schlüsselcontainer ist bereits geöffnet. Diese Fehlermeldung kann angezeigt werden, wenn Sie bereits Open oder Create aufgerufen haben.
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)	Der Schlüssel wurde von einem CryptoAPI-CSP erstellt, und Sie haben einen anderen Wert als BCRYPT_PRIVATE_KEY_BLOB für den strExportType-Parameter angegeben.

Hinweise

Die Importfunktion geht automatisch davon aus, dass Sie versuchen, einen CNG-KSP-Schlüssel zu importieren, wenn Sie einen anderen Wert als BCRYPT_PRIVATE_KEY_BLOB für den strExportType-Parameter angeben und keine der folgenden Eigenschaften festlegen:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

IX509PrivateKey

Freigeben über