通过

IX509EnrollmentPolicyServer：：Initialize 方法 (certenroll.h)

  • 项目

Initialize 方法初始化 IX509EnrollmentPolicyServer 对象。

语法

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

参数

[in] bstrPolicyServerUrl

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

[in] bstrPolicyServerId

包含证书注册策略服务器的唯一 ID 的 BSTR 变量。 如果此值不为 NULL，则它必须与 CEP 响应返回的 ID 字符串匹配。

[in] authFlags

指定客户端身份验证类型的 X509EnrollmentAuthFlags 枚举值。 这可以是以下值之一。

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

[in] fIsUnTrusted

一个布尔值，指定是否允许不受信任的证书颁发机构证书。

[in] context

一个 X509CertificateEnrollmentContext 枚举值，该值指定要为其注册证书的最终实体的性质。 这可以是以下值之一。

值 含义
ContextUser
 证书适用于最终用户。
ContextMachine
 该证书适用于计算机。
ContextAdministratorForceMachine
 代表计算机的管理员正在请求证书。

返回值

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

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

返回代码 说明
E_INVALIDARG
 bstrPolicyServerUrl 参数不能是空字符串，必须表示 HTTPS URL。
E_OUTOFMEMORY
 对于 bstrPolicyServerUrl 或 bstrPolicyServerId 参数中指定的字符串，内存不足。
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
IX509EnrollmentPolicyServer 对象已初始化。
HRESULT_FROM_WIN32 (ERROR_INVALID_DATA)
bstrPolicyServerId 参数中指定的值不为 NULL，并且不等于 CEP 服务器上的现有 CEP ID 值。

要求

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

另请参阅

IX509EnrollmentPolicyServer