IX509PrivateKey::Import メソッド (certenroll.h)

  • [アーティクル]

Import メソッドは、暗号化プロバイダー内のキー コンテナーに既存の秘密キーをインポートします。

構文

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

パラメーター

[in] strExportType

キーが CNG KSP (キー ストレージ プロバイダー) を使用して作成された場合、Import メソッドは NCryptSetProperty 関数の pszProperty パラメーターにこの引数を渡します。 つまり、指定した値は、インポートされたキーに設定するプロパティの名前として使用されます。

キーが CryptoAPI CSP (暗号化サービス プロバイダー) を使用して作成された場合、この引数は秘密キーのインポート方法を指定します。 次の値を指定できます。

値 意味
BCRYPT_PRIVATE_KEY_BLOB
 秘密キー全体をインポートします。

[in] strEncodedKey

インポートするキーを含む BSTR 変数。

[in] Encoding

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

戻り値

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

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

リターン コード 説明
HRESULT_FROM_WIN32(ERROR_FILE_READ_ONLY)
 キー コンテナーは既に開いています。 このエラーは、 Open または Create を既に呼び出している場合に表示されます。
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 キーは CryptoAPI CSP によって作成され、 strExportType パラメーターにBCRYPT_PRIVATE_KEY_BLOB以外の値を指定しました。

注釈

import 関数は、strExportType パラメーターにBCRYPT_PRIVATE_KEY_BLOB以外の値を指定し、次のプロパティを設定しない場合、CNG KSP キーのインポートを試みていると自動的に想定します。

要件

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

こちらもご覧ください

IX509PrivateKey