IX509CertificateRequestPkcs10::InitializeFromTemplateName メソッド (certenroll.h)

InitializeFromTemplateName メソッドは、テンプレートを使用して証明書要求を初期化します。

構文

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

[in] Context

要求された証明書が、エンドユーザー、コンピューター、またはコンピューターの代わりに動作する管理者を対象とするかどうかを指定する X509CertificateEnrollmentContext 列挙値。

[in] strTemplateName

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

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

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

リターンコード/値	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	証明書要求オブジェクトは既に初期化されています。

InitializeFromTemplateName メソッドは、次のコレクションを作成します。

ICryptAttributes コレクション。
IX509Extensions コレクション。
既定のXCN_OID_KEY_USAGEとXCN_OID_BASIC_CONSTRAINTS2オブジェクト識別子が設定された IObjectIds コレクション。
新しい要求から抑制される属性および拡張 OID の空の IObjectIds コレクション。

次に、メソッドはテンプレートを調べて、次のアクションを実行します。

テンプレートで指定された拡張機能を IX509Extensions コレクションに追加します。
既定の重要な拡張機能 (XCN_OID_KEY_USAGEとXCN_OID_BASIC_CONSTRAINTS2) をコレクションから削除します (テンプレートが重要ではないことが示されている場合)。テンプレートによってクリティカルとマークされた OID が追加されます。
テンプレートが対称アルゴリズムをサポートしている場合は、SmimeCapabilities プロパティを設定します。
テンプレートに個別の署名アルゴリズム OID が必要な場合は、AlternateSignatureAlgorithm プロパティを設定します。
IX509SignatureInformation オブジェクトを作成します。
テンプレートでアルゴリズムが指定されている場合は、ハッシュアルゴリズム OID を作成し、 IX509SignatureInformation オブジェクトに設定します。
テンプレートでアルゴリズムが指定され、 IX509SignatureInformation オブジェクトに設定されている場合は、非対称暗号化アルゴリズム OID を作成します。
テンプレート設定から次の IX509PrivateKey プロパティを設定します。

CSPInformations プロパティが NULL の場合、メソッドはコンピューターにインストールされているプロバイダーから ICspInformations コレクションを作成します。