IX509PrivateKey::Export-Methode (certenroll.h)
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 |
|---|---|
|
Exportiert nur den öffentlichen Teil des privaten Schlüssels. |
|
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 |
|---|---|
|
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 |