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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 オブジェクトは既に初期化されています。

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

こちらもご覧ください

ICertProperty

ICertPropertyEnrollment