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 请求对象,并将以下属性设置为调用此方法之前存在的值:

方法创建以下集合:

然后, 方法检查模板并执行以下操作:

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

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

IX509CertificateRequestPkcs7