ICertSrvSetup::CAImportPFX メソッド (casetup.h)

  • [アーティクル]

CAImportPFX メソッドは、証明機関 (CA) 証明書とそれに関連付けられている秘密キーをローカル コンピューター ストアにインポートします。 このメソッドは 、CCertSrvSetup オブジェクトの状態を変更しません。

構文

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

パラメーター

[in] bstrFileName

秘密キーのインポートに使用される PFX ファイルの名前を含む文字列。

[in] bstrPasswd

PFX ファイルのパスワードを含む文字列。

[in] bOverwriteExistingKey

同じ名前の既存のキーを上書きするかどうかを示す 値。

[out] ppVal

インポートされた秘密キーのプロパティを設定するために使用できる ICertSrvSetupKeyInformation インターフェイスへのポインターのアドレス。

戻り値

なし

解説

CAImportPFX メソッドは、入力パラメーターを使用して PFX ファイルの暗号化を解除してデコードし、キーと証明書をローカル コンピューター ストアにインストールします。 証明書が次の条件を満たし、キーのインストール後に、メソッドは ICertSrvSetupKeyInformation オブジェクトを呼び出し元に返します。

  • 秘密キー コンテナー内のキーと一致するAT_SIGNATURE キーが含まれます。
  • 自己署名されているか、CA の基本的な制約があります。
  • チェーン検証に合格しますが、オフライン失効エラーが発生する可能性があります。
PFX ファイルに複数の証明書とキーが含まれている場合、 CAImportPFX はすべての証明書とキーをインストールします。ただし、返された ICertSrvSetupKeyInformation オブジェクトには、ファイル内の最後の CA 証明書のプロパティのみが含まれます。 呼び出し元が ICertSrvSetupKeyInformation オブジェクトの使用を完了したら、呼び出し元は Release メソッドを使用して解放する必要があります。

要件

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

こちらもご覧ください

ICertSrvSetup