通过

iCertPropertyEnrollment：：Initialize 方法 (certenroll.h)

  • 项目

Initialize 方法从证书请求 ID、证书颁发机构 (CA) 配置字符串和可选的证书显示名称初始化 属性。

语法

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

参数

[in] RequestId

包含证书请求 ID 的 LONG 变量。 请求 ID 由注册过程创建。 可以通过在 IX509Enrollment 接口上调用 RequestId 属性来检索此值。

[in] strCADnsName

包含域名系统 (DNS) CA 名称的 BSTR 变量。 这是 CADnsName\CAName CA 配置字符串中的名字。 配置字符串通常在注册过程中设置。 可以通过调用 CAConfigString 属性并将字符串分隔为其构成部分来检索 DNS 名称。

[in] strCAName

包含 CA 的使用者公用名 (CN) 的 BSTR 变量。 这是 CADnsName\CAName CA 配置字符串中的第二个名称。 配置字符串通常在注册过程中设置。 可以通过调用 CAConfigString 属性并将字符串分隔为其构成部分来检索 CN 名称。

[in, optional] strFriendlyName

包含证书的可选显示名称的 BSTR 变量。 默认值为 NULL。 此值通常在注册过程中设置。 可以通过调用 CertificateFriendlyName 属性来检索它。

返回值

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

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

返回代码/值 说明
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
对象已初始化。

注解

当客户端对 IX509Enrollment 对象调用 Enroll 方法时，在证书注册过程中设置可用于初始化 ICertPropertyEnrollment 对象的值。 也就是说，若要检索请求 ID，请在 IX509Enrollment 对象上调用 RequestId 属性。 若要检索证书显示名称，请调用 CertificateFriendlyName 属性。 若要检索可分辨名称和公用名，请调用 CAConfigString 属性，并将配置字符串分成多个组成部分。

调用 SetValueOnCertificate 方法将 属性与证书相关联。 还可以调用以下属性来检索初始化期间指定的值：

要求

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

另请参阅

ICertProperty

ICertPropertyEnrollment