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 値」を参照してください。

注釈

ICertPropertyEnrollment オブジェクトの初期化に使用できる値は、クライアントが IX509Enrollment オブジェクトの Enroll メソッドを呼び出すときに、証明書登録プロセス中に設定されます。 つまり、要求 ID を取得するには、IX509Enrollment オブジェクトの RequestId プロパティを呼び出します。 証明書の表示名を取得するには、 CertificateFriendlyName プロパティを呼び出します。 識別名と共通名を取得するには、 CAConfigString プロパティを呼び出し、構成文字列を構成要素に分けます。

SetValueOnCertificate メソッドを呼び出して、プロパティを証明書に関連付けます。 次のプロパティを呼び出して、初期化中に指定された値を取得することもできます。

• CADnsName
• CAName
• FriendlyName
• RequestId

要件

こちらもご覧ください

ICertProperty

ICertPropertyEnrollment