Freigeben über

IX509PrivateKey::Export-Methode (certenroll.h)

  • Artikel

Die Export-Methode kopiert den privaten Schlüssel in ein Bytearray. Das Bytearray wird durch eine Unicode-codierte Zeichenfolge dargestellt.

Syntax

HRESULT Export(
  [in]  BSTR         strExportType,
  [in]  EncodingType Encoding,
  [out] BSTR         *pstrEncodedKey
);

Parameter

[in] strExportType

Ein BSTR-Wert , der angibt, wie der private Schlüssel exportiert wird.

Wenn der Schlüssel mithilfe eines CNG-KSP (Key Storage Provider) erstellt wurde, können Sie einen der vom pszBlobType-Parameter zulässigen Werte in der NCryptExportKey-Funktion angeben.

Wenn der Schlüssel mit einem CryptoAPI-CSP (Cryptographic Service Provider) erstellt wurde, können Sie einen der folgenden Werte aus der In Wincrypt.h enthaltenen Headerdatei Bcrypt.h angeben.

Wert Bedeutung
BCRYPT_PUBLIC_KEY_BLOB
 Exportiert nur den öffentlichen Teil des privaten Schlüssels.
BCRYPT_PRIVATE_KEY_BLOB
 Exportiert den gesamten privaten Schlüssel.

[in] Encoding

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

[out] pstrEncodedKey

Zeiger auf eine BSTR-Variable , die den privaten Schlüssel enthält.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, 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_CALL_NOT_IMPLEMENTED)
 Der Schlüssel wurde von einem CryptoAPI-CSP erstellt, und Sie haben einen anderen Wert als BCRYPT_PRIVATE_KEY_BLOB oder BCRYPT_PUBLIC_KEY_BLOB für den strExportType-Parameter angegeben.

Anforderungen

   
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