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 ヘッダー ファイルから次のいずれかの値を指定できます。

値 意味
BCRYPT_PUBLIC_KEY_BLOB
 秘密キーの公開部分のみをエクスポートします。
BCRYPT_PRIVATE_KEY_BLOB
 秘密キー全体をエクスポートします。

[in] Encoding

pstrEncodedKey パラメーターに含まれる文字列に適用する Unicode エンコードの種類を指定する EncodingType 列挙値。 既定値は XCN_CRYPT_STRING_BASE64 です。

[out] pstrEncodedKey

秘密キーを含む BSTR 変数へのポインター。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

リターン コード 説明
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 キーは CryptoAPI CSP によって作成され、 strExportType パラメーターにBCRYPT_PRIVATE_KEY_BLOBまたはBCRYPT_PUBLIC_KEY_BLOB以外の値を指定しました。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

関連項目

IX509PrivateKey