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

Initialize メソッドは、ユーザーまたはコンピューターの要求オブジェクトを初期化します。

構文

HRESULT Initialize(
  [in] X509CertificateEnrollmentContext Context
);

[in] Context

証明書がエンドユーザー、コンピューター、またはコンピューターの代わりに動作する管理者を対象とするかどうかを指定する X509CertificateEnrollmentContext 列挙値。次のいずれかの値を指定できます。

値	意味
ContextUser	エンドユーザーに対して証明書が要求されています。
ContextMachine	コンピューターに対して証明書が要求されています。
ContextAdministratorForceMachine	証明書は、コンピューターの代わりに機能する管理者によって要求されています。

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

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

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

Initialize メソッドは、作成される証明書要求の種類に応じて、さまざまなオブジェクトを初期化します。 IX509CertificateRequestPkcs10 オブジェクトからこのメソッドを呼び出すと、秘密キーオブジェクトが作成され、次のオブジェクトが初期化されます。

空の ICryptAttributes コレクション。
空の IX509Extensions コレクション。
既定の重要な拡張オブジェクト識別子、XCN_OID_KEY_USAGE、XCN_OID_BASIC_CONSTRAINTS2を含む IObjectIds コレクション。このコレクションは、 CriticalExtensions プロパティを呼び出すことによって取得できます。
SuppressOids プロパティの空の IObjectIds コレクション。
CSPInformations プロパティで指定した値、またはコンピューターにインストールされているすべてのプロバイダーのコレクションを含む ICspInformations オブジェクト。このコレクションは、秘密キーを作成するために使用されます。

IX509CertificateRequestCmc オブジェクトからこのメソッドを呼び出すと、上記のように内部 PKCS #10 要求が作成され、次のオブジェクトが初期化されます。

空の ICryptAttributes コレクション。
空の IX509NameValuePairs コレクション。
空の IX509Extensions コレクション。
既定の重要な拡張オブジェクト識別子、XCN_OID_KEY_USAGE、XCN_OID_BASIC_CONSTRAINTS2を含む IObjectIds コレクション。このコレクションは、 CriticalExtensions プロパティを呼び出すことによって取得できます。
SuppressOids プロパティの空の IObjectIds コレクション。
空の ISignerCertificates コレクション。

IX509CertificateRequestPkcs7 オブジェクトからこのメソッドを呼び出すと、上記のように内部 PKCS #10 要求が作成されます。

このメソッドを呼び出す前に、次のプロパティを呼び出すことができます。

ICspInformations コレクションを指定する場合は、このメソッドを呼び出す前に CSPInformations プロパティを呼び出す必要があります。