通过

ICertificateEnrollmentPolicyServerSetup：：GetProperty 方法 (casetup.h)

  • 项目

GetProperty 方法检索证书注册策略的 CEPSetupProperty 枚举值， (CEP) Web 服务配置。

语法

HRESULT GetProperty(
  [in]  CEPSetupProperty propertyId,
  [out] VARIANT          *pPropertyValue
);

参数

[in] propertyId

CEPSetupProperty 枚举的值，指定要设置的属性值。 以下值有效。

值 说明
ENUM_CEPSETUPPROP_AUTHENTICATION pPropertyValue 参数包含一个值，该值标识要使用的身份验证类型。
ENUM_CEPSETUPPROP_SSLCERTHASH pPropertyValue 参数包含身份验证期间使用的证书的哈希（如果有）。
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL pPropertyValue 参数指定是否在仅返回 KeyBasedRenewal 模板策略的模式下设置注册策略服务器。
ENUM_CEPSETUPPROP_URL 包含 CEP 服务 URL。 如果 GetProperty 方法成功返回， pPropertyValue 参数将包含 一个VT_BSTR 子类型，该子类型包含格式为“https:// computerDNSname/ADPolicyProvider_cep_AuthenticationType/service.svc/cep”的 URL，其中身份验证类型可以是以下类型之一：
  • Kerberos
  • usernamepassword
  • 证书 (certificate)

[out] pPropertyValue

指向包含属性值的 VARIANT 变量的指针。

如果在 propertyId 参数中指定ENUM_CEPSETUPPROP_AUTHENTICATION，则如果 GetProperty 方法成功返回，pPropertyValue 参数将包含以下常量之一：

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

如果在 propertyId 参数中指定ENUM_CEPSETUPPROP_SSLCERTHASH，则如果 GetProperty 方法成功返回，pPropertyValue 参数将包含包含哈希的VT_BSTR子类型。

如果在 propertyId 参数中指定ENUM_CEPSETUPPROP_AUTHENTICATION，pPropertyValue 参数将包含身份验证过程。

如果在 propertyId 参数中指定ENUM_CEPSETUPPROP_URL，pPropertyValue 参数将包含证书注册策略 (CEP) Web 服务 URL。

如果在 propertyId 参数中指定ENUM_CEPSETUPPROP_KEYBASED_RENEWAL，则必须将 pPropertyValue 参数设置为VT_BOOL子类型，该子类型指示是否在仅返回 KeyBasedRenewal 模板策略的模式下设置注册策略服务器。

返回值

返回代码 说明
E_INVALIDARG
 propertyId 参数不是 CEPSetupProperty 枚举类型的成员。
E_POINTER
 pPropertyValue 参数不能为 NULL。
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
ICertificateEnrollmentPolicyServerSetup 对象尚未初始化。

ErrorString 属性值设置为“尚未初始化安装程序对象。 请使用 InitializeInstallDefaults 方法初始化安装程序对象。”

要求

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

另请参阅

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty