IX509Enrollment2::InitializeFromTemplate メソッド (certenroll.h)

InitializeFromTemplate メソッドは、テンプレートを使用して登録オブジェクトを初期化します。

構文

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

パラメーター

[in] context

要求された登録が、ユーザー、コンピューター、またはコンピューターの代わりに動作する管理者用であるかどうかを示す X509CertificateEnrollmentContext 列挙値。 次のいずれかの値を指定できます。

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

[in] pPolicyServer

pTemplate パラメーターで指定されたテンプレートを含む証明書登録ポリシー (CEP) サーバーを表す IX509EnrollmentPolicyServer オブジェクトへのポインター。

[in] pTemplate

初期化中に使用するテンプレートを表す IX509CertificateTemplate オブジェクトへのポインター。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

戻りコード/値 Description
E_POINTER
 pPolicyServer パラメーターと pTemplate パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 登録オブジェクトは既に初期化されています。

注釈

InitializeFromTemplate メソッド:

  • テンプレートを調べて、必要な要求の種類を判断します。
  • 適切な種類の要求オブジェクト (PKCS #10、PKCS #7、または CMC) を作成します。
  • 値が現在存在する場合は、要求に次のプロパティを設定します。
  • テンプレートを使用して要求オブジェクトを初期化します。
  • テンプレートから署名数、発行ポリシー、およびアプリケーション ポリシーを取得します。

Requirements

Requirement 価値
サポートされる最小クライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
Header certenroll.h

こちらも参照ください

IX509Enrollment2

  • Last updated on