ICertPropertyEnrollment::Initialize メソッド (certenroll.h)
Initialize メソッドは、証明書要求 ID、証明機関 (CA) 構成文字列、およびオプションの証明書表示名から プロパティを初期化します。
構文
HRESULT Initialize(
[in] LONG RequestId,
[in] BSTR strCADnsName,
[in] BSTR strCAName,
[in, optional] BSTR strFriendlyName
);
パラメーター
[in] RequestId
証明書要求 ID を含む LONG 変数。 要求 ID は、登録プロセスによって作成されます。 この値を取得するには、IX509Enrollment インターフェイスで RequestId プロパティを呼び出します。
[in] strCADnsName
CA のドメイン ネーム システム (DNS) 名を含む BSTR 変数。 これは、 CADnsName\CAName CA 構成文字列の最初の名前です。 通常、構成文字列は登録プロセス中に設定されます。 DNS 名を取得するには、 CAConfigString プロパティを呼び出し、その構成要素に文字列を分離します。
[in] strCAName
CA のサブジェクト共通名 (CN) を含む BSTR 変数。 これは、 CADnsName\CAName CA 構成文字列の 2 番目の名前です。 通常、構成文字列は登録プロセス中に設定されます。 CN 名は、 CAConfigString プロパティを呼び出し、その構成要素に文字列を分離することで取得できます。
[in, optional] strFriendlyName
証明書のオプションの表示名を含む BSTR 変数。 既定値は NULL です。 この値は通常、登録プロセス中に設定されます。 CertificateFriendlyName プロパティを呼び出すことで取得できます。
戻り値
関数が成功した場合、関数は S_OKを返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。
| リターン コード/値 | Description |
|---|---|
|
オブジェクトは既に初期化されています。 |
注釈
ICertPropertyEnrollment オブジェクトの初期化に使用できる値は、クライアントが IX509Enrollment オブジェクトの Enroll メソッドを呼び出すときに、証明書登録プロセス中に設定されます。 つまり、要求 ID を取得するには、IX509Enrollment オブジェクトの RequestId プロパティを呼び出します。 証明書の表示名を取得するには、 CertificateFriendlyName プロパティを呼び出します。 識別名と共通名を取得するには、 CAConfigString プロパティを呼び出し、構成文字列を構成要素に分けます。
SetValueOnCertificate メソッドを呼び出して、プロパティを証明書に関連付けます。 次のプロパティを呼び出して、初期化中に指定された値を取得することもできます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certenroll.h |
| [DLL] | CertEnroll.dll |