IX509Enrollment2::InitializeFromTemplate 方法 (certenroll.h)

InitializeFromTemplate 方法使用模板初始化注册对象。

Syntax

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

参数

[in] context

X509CertificateEnrollmentContext 枚举值,该值指示请求的注册是针对用户、计算机还是代表计算机的管理员。 这可以是以下值之一。

价值 Meaning
ContextUser
正在请求最终用户的证书。
ContextMachine
正在为计算机请求证书。
ContextAdministratorForceMachine
代理计算机的管理员正在请求证书。

[in] pPolicyServer

指向表示证书注册策略 (CEP) 服务器的 IX509EnrollmentPolicyServer 对象的指针,该服务器包含 pTemplate 参数指定的模板。

[in] pTemplate

指向表示初始化期间要使用的模板的 IX509CertificateTemplate 对象的指针。

返回值

如果函数成功,该函数将返回 S_OK

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

返回代码/值 Description
E_POINTER
pPolicyServerpTemplate 参数不能为 NULL
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
注册对象已初始化。

注解

InitializeFromTemplate 方法:

  • 检查模板以确定所需的请求类型。
  • 创建适当的请求对象类型(PKCS #10、PKCS #7 或 CMC)。
  • 如果当前存在值,请在请求上设置以下属性:
  • 使用模板初始化请求对象。
  • 从模板中检索签名计数、颁发策略和应用程序策略。

要求

Requirement 价值
最低支持的客户端 Windows 7 [仅限桌面应用]
支持的最低服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows操作系统
Header certenroll.h

另请参阅

IX509Enrollment2