IX509CertificateRequestCmc::InitializeFromInnerRequestTemplateName メソッド (certenroll.h)

InitializeFromInnerRequestTemplateName メソッドは、内部要求オブジェクトとテンプレートからの証明書要求を初期化します。

構文

HRESULT InitializeFromInnerRequestTemplateName(
  [in] IX509CertificateRequest *pInnerRequest,
  [in] BSTR                    strTemplateName
);

[in] pInnerRequest

内部要求オブジェクトを表す IX509CertificateRequest インターフェイスへのポインター。 PKCS #10 または CMC 要求を指定できます。

[in] strTemplateName

Active Directory またはドット 10 進オブジェクト識別子に表示されるテンプレートの共通名 (CN) を含む BSTR 変数。

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。有効な値を次の表に示しますが、これ以外にもあります。一般的なエラーコードの一覧については、「共通 HRESULT 値」を参照してください。

リターンコード/値	Description
CRYPT_E_INVALID_MSG_TYPE	pInnerRequest パラメーターに渡される要求オブジェクトは、PKCS #10 または CMC 要求である必要があります。
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	要求オブジェクトは既に初期化されています。

テンプレートを指定することで、内部要求に含まれていない可能性がある外部要求オブジェクトに情報を追加できます。たとえば、内部要求に必要な拡張機能が含まれていない場合は、そのテンプレートを指定できます。

InitializeFromInnerRequestTemplateName メソッド:

空の ICryptAttributes コレクションを作成します。
空の IX509NameValuePairs コレクションを作成します。
空の IX509Extensions コレクションを作成します。
重要な拡張機能の IObjectIds コレクションを作成し、XCN_OID_KEY_USAGEとXCN_OID_BASIC_CONSTRAINTS2オブジェクト識別子 (OID) を追加します。
要求オブジェクトから抑制される OID の空の IObjectIds コレクションを作成します。
空の ISignerCertificates コレクションを作成します。
テンプレートから秘密キーフラグを取得します。
テンプレートのフラグまたは設定で必要な場合は、 ArchivePrivateKey プロパティを設定します。
暗号化アルゴリズムが指定されている場合は、テンプレートから暗号化アルゴリズムを取得し、 EncryptionAlgorithm プロパティを設定します。
可能であれば、 EncryptionStrength プロパティを設定します。