通过

ICertPropertyEnrollmentPolicyServer：：Initialize 方法 (certenroll.h)

  • 项目

Initialize 方法初始化 ICertPropertyEnrollmentPolicyServer 对象。

语法

HRESULT Initialize(
  [in] EnrollmentPolicyServerPropertyFlags PropertyFlags,
  [in] X509EnrollmentAuthFlags             AuthFlags,
  [in] X509EnrollmentAuthFlags             EnrollmentServerAuthFlags,
  [in] PolicyServerUrlFlags                UrlFlags,
  [in] BSTR                                strRequestId,
  [in] BSTR                                strUrl,
  [in] BSTR                                strId,
  [in] BSTR                                strEnrollmentServerUrl
);

参数

[in] PropertyFlags

EnrollmentPolicyServerPropertyFlags 枚举值，该值指定 CEP) 服务器 (默认证书注册策略。 这可以是以下值之一。

值 含义
DefaultNone
 未指定默认策略服务器 URL。
DefaultPolicyServer
 未指定 URL 时， GetPolicyServerUrl 返回的策略服务器 URL 为默认值。

[in] AuthFlags

一个 X509EnrollmentAuthFlags 枚举值，该值指定客户端用于向 CEP 服务器进行身份验证的身份验证类型。 这可以是以下值之一。

值 含义
X509AuthAnonymous
 匿名身份验证。
X509AuthKerberos
 Kerberos 身份验证。
X509AuthUsername
 明文用户名和密码身份验证。
注意 用户名和密码在传输之前进行加密，并安全地存储在服务器上的凭据保管库中。
 
X509AuthCertificate
 客户端身份验证证书安装在本地计算机上，并由服务器用来验证客户端的身份。

[in] EnrollmentServerAuthFlags

一个 X509EnrollmentAuthFlags 枚举值，该值指定客户端用于向 CES 进行身份验证的身份验证类型。 有关枚举类型的可能值，请参阅 AuthFlags 参数。 对于 Windows 7，只能指定 X509AuthCertificate 。

[in] UrlFlags

一个 PolicyServerUrlFlags 枚举值，该值指定策略服务器标志。 这可以是以下值的按位 或 。

值 含义
PsfNone
 未指定任何标志。
PsfLocationGroupPolicy
 策略服务器 URL 由管理员在组策略中指定。
PsfLocationRegistry
 策略服务器 URL 在注册表中指定。
PsfUseClientId
 指定证书注册和续订包括 ClientId 属性中的客户端特定数据。 示例包括加密服务提供程序的名称、Windows 版本号、用户名、计算机 DNS 名称和域控制器 DNS 名称。

包含此标志可以解决注册到服务器期间可能出现的隐私问题，这些服务器由管理员管理，但管理员管理用户所在的林除外。 如果不设置此标志，可以阻止向非本地管理员发送个人信息。
PsfAutoEnrollmentEnabled
 已启用自动证书注册。
PsfAllowUnTrustedCA
 指定客户端无需信任颁发 CA 的证书，就可以安装由 CA 签名的证书。

[in] strRequestId

一个 BSTR 变量，其中包含注册期间要发送到证书颁发机构的证书请求的唯一字符串标识符。 字符串可以包含唯一标识请求的任何信息。

[in] strUrl

一个 BSTR 变量，其中包含证书注册策略的 URL (CEP) 服务器。

[in] strId

包含 CEP 服务器的 ID 的 BSTR 变量。

[in] strEnrollmentServerUrl

包含证书注册服务器的 URL 的 BSTR 变量。

返回值

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

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

返回代码 说明
E_OUTOFMEMORY
 字符串值可用的内存不足。

要求

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

另请参阅

ICertPropertyEnrollmentPolicyServer