IX509PrivateKey::Export 方法 (certenroll.h)
Export方法會將私密金鑰複製到位元組陣列。 位元組陣列是以 Unicode 編碼字串表示。
語法
HRESULT Export(
[in] BSTR strExportType,
[in] EncodingType Encoding,
[out] BSTR *pstrEncodedKey
);
參數
[in] strExportType
指定如何匯出私密金鑰的 BSTR 值。
如果使用 CNG KSP (金鑰儲存提供者) 建立金鑰,您可以在NCryptExportKey函式中指定pszBlobType參數允許的其中一個值。
如果使用 CryptoAPI CSP (密碼編譯服務提供者) 建立金鑰,您可以從 Wincrypt.h 隨附的 Bcrypt.h 標頭檔中指定下列其中一個值。
值 | 意義 |
---|---|
|
僅匯出私密金鑰的公開部分。 |
|
匯出整個私密金鑰。 |
[in] Encoding
EncodingType列舉值,指定要套用至pstrEncodedKey參數中包含的字串的 Unicode 編碼類型。 預設值為 XCN_CRYPT_STRING_BASE64。
[out] pstrEncodedKey
包含私密金鑰的 BSTR 變數指標。
傳回值
如果函式成功,函式會傳回 S_OK。
如果函式失敗,它會傳回 指出錯誤的 HRESULT 值。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
傳回碼 | Description |
---|---|
|
金鑰是由 CryptoAPI CSP 所建立,而且您指定 了 strExportType 參數BCRYPT_PRI加值稅E_KEY_BLOB或BCRYPT_PUBLIC_KEY_BLOB以外的值。 |
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | certenroll.h |
Dll | CertEnroll.dll |