ICEnroll4::createPFX メソッド (xenroll.h)

  • [アーティクル]

[このメソッドは、Windows Server 2008 および Windows Vista では使用できなくなりました。

createPFX メソッドは、受け入れられた証明書チェーンと秘密キーを個人情報交換 (PFX) 形式の文字列に保存します。 PFX 形式は PKCS #12 とも呼ばれます。

このメソッドは、 ICEnroll4 インターフェイスで最初に定義されました。

構文

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

パラメーター

[in] strPassword

PFX 形式のメッセージのパスワード。 この値は、パスワードが使用されていないことを示す空または NULL にすることができます 。 パスワードの使用が完了したら、 SecureZeroMemory 関数を呼び出してメモリからクリアします。 パスワードの保護の詳細については、「パスワードの 処理」を参照してください。

[out] pstrPFX

base64 でエンコードされた PFX 形式の証明書情報を受け取る BSTR へのポインター。 BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

VB

戻り値は、PFX 形式の証明書情報を含む String です。

解説

このメソッドは、証明書登録コントロールがスクリプト化されたコントロールとして実行されるときに無効になります。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー xenroll.h
Library Uuid.lib
[DLL] Xenroll.dll