IX509CertificateRequestPkcs7：：InitializeFromTemplateName 方法 (certenroll.h)

InitializeFromTemplateName 方法使用模板初始化证书请求。

语法

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

[in] Context

一个 X509CertificateEnrollmentContext 枚举值，该值指定请求的证书是面向最终用户、计算机还是代表计算机的管理员。

[in] strTemplateName

一个 BSTR 变量，其中包含模板的公用名 (CN) ，如 Active Directory 中所示或带点的十进制对象标识符。

如果函数成功，该函数将返回 S_OK。

如果函数失败，它将返回指示错误的 HRESULT 值。可能的值包括（但并不限于）下表中的项。有关常见错误代码的列表，请参阅常见 HRESULT 值。

返回代码/值	说明
ERROR_ALREADY_INITIALIZED	证书请求对象已初始化。

InitializeFromTemplateName 方法创建 PKCS #7 请求对象，并将以下属性设置为调用此方法之前存在的值：

方法创建以下集合：

然后，方法检查模板并执行以下操作：

将模板指定的扩展添加到 IX509Extensions 集合。
如果模板指示它们不重要，则从集合中删除默认关键扩展 (XCN_OID_KEY_USAGE 和XCN_OID_BASIC_CONSTRAINTS2) 。将添加模板标记为“关键”的 OID。
如果模板支持对称算法，则设置 SmimeCapabilities 属性。
如果模板需要离散签名算法 OID，则设置 AlternateSignatureAlgorithm 属性。
创建 IX509SignatureInformation 对象。
如果在模板中指定了该算法，并在 IX509SignatureInformation 对象上设置该算法，则创建哈希算法 OID。
如果在模板中指定了算法并在 IX509SignatureInformation 对象上设置该算法，则创建非对称加密算法 OID。
从模板设置中设置以下 IX509PrivateKey 属性：
- KeySpec
- KeyUsage
- 时长
- ExportPolicy
- KeyProtection
- SecurityDescriptor
- Silent
- MachineContext
- 算法

如果 CSPInformations 属性为 NULL，该方法将从计算机上安装的提供程序创建 ICspInformations 集合。

最后，方法将初始化的 PKCS #10 请求设置为内部请求对象。