IX509CertificateRequestCmc2::InitializeFromInnerRequestTemplate メソッド (certenroll.h)
InitializeFromInnerRequestTemplate メソッドは、内部要求オブジェクトとテンプレートからの証明書要求を初期化します。
構文
HRESULT InitializeFromInnerRequestTemplate(
[in] IX509CertificateRequest *pInnerRequest,
[in] IX509EnrollmentPolicyServer *pPolicyServer,
[in] IX509CertificateTemplate *pTemplate
);
パラメーター
[in] pInnerRequest
内部要求オブジェクトを表す IX509CertificateRequest インターフェイスへのポインター。 PKCS #10 または CMC 要求を指定できます。
[in] pPolicyServer
pTemplate パラメーターで指定されたテンプレートを含む証明書登録ポリシー (CEP) サーバーを表す IX509EnrollmentPolicyServer オブジェクトへのポインター。
[in] pTemplate
初期化時に使用するテンプレートを表す IX509CertificateTemplate オブジェクトへのポインター。
戻り値
関数が成功した場合、関数は S_OKを返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
| リターン コード/値 | Description |
|---|---|
|
pInnerRequest パラメーターに渡される要求オブジェクトは、PKCS #10 または CMC 要求である必要があります。 |
|
pInnerRequest、pPolicyServer、および pTemplate パラメーターを NULL にすることはできません。 |
|
要求オブジェクトは既に初期化されています。 |
注釈
テンプレートを指定することで、内部要求に含まれていない可能性がある外部要求オブジェクトに情報を追加できます。 たとえば、内部要求に必要な拡張機能が含まれていない場合は、そのテンプレートを指定できます。
InitializeFromInnerRequestTemplate メソッド:
- 空の ICryptAttributes コレクションを作成します 。
- 空の IX509NameValuePairs コレクションを作成します 。
- 空の IX509Extensions コレクションを作成します 。
- 重要な拡張機能の IObjectIds コレクションを作成し、XCN_OID_KEY_USAGEとXCN_OID_BASIC_CONSTRAINTS2オブジェクト識別子 (OID) を追加します。
- 要求オブジェクトから抑制される OID の空の IObjectIds コレクションを作成します。
- 空の ISignerCertificates コレクションを 作成します。
- テンプレートから秘密キー フラグを取得します。
- テンプレート フラグまたは設定で必要な場合は、 ArchivePrivateKey プロパティを設定します。
- テンプレートが指定されている場合は、テンプレートから暗号化アルゴリズムを取得し、 EncryptionAlgorithm プロパティを設定します。
- 可能であれば EncryptionStrength プロパティを設定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certenroll.h |