ICspStatus::Initialize メソッド (certenroll.h)

Initialize メソッドは、暗号化プロバイダーと関連付けられたアルゴリズムからオブジェクトを初期化します。このメソッドは Web 対応です。

構文

HRESULT Initialize(
  [in]           ICspInformation *pCsp,
  [in, optional] ICspAlgorithm   *pAlgorithm
);

[in] pCsp

プロバイダーに関する情報を表す ICspInformation インターフェイスへのポインター。

[in, optional] pAlgorithm

pCsp パラメーターで識別されたプロバイダーによってサポートされるアルゴリズムを表す ICspAlgorithm インターフェイスへのポインター。このパラメーターは省略可能であり、 NULL にすることができます。

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

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

リターンコード/値	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

Initialize メソッドは、CspInformation プロパティと CspAlgorithm プロパティで指定した ICspInformation オブジェクトと ICspAlgorithm オブジェクトを保存します。また、メソッドは空の IX509EnrollmentStatus オブジェクトを作成し、 EnrollmentStatus プロパティに保存します。

ICspStatuses コレクションは通常、IX509CertificateRequestPkcs10 オブジェクトによって初期化されます。 Initialize メソッドは、カスタムコレクションに追加する ICspStatus オブジェクトを作成できるように提供されています。