ICertificateEnrollmentServerSetup：：GetProperty 方法 (casetup.h)

GetProperty 方法检索证书注册 Web 服务 (CES) 配置的 CESSetupProperty 枚举值。

语法

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

[in] propertyId

一个 CESSetupProperty 枚举值，该值指定要检索的属性值。有关详细信息，请参阅“备注”。

[out] pPropertyValue

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

返回代码	说明
E_INVALIDARG	propertyId 参数不是 CESSetupProperty 枚举类型的成员。
E_POINTER	pPropertyValue 参数不能为 NULL。
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)	ICertificateEnrollmentServerSetup 对象尚未初始化。 ErrorString 属性值设置为“尚未初始化安装程序对象。请使用 InitializeInstallDefaults 方法初始化安装程序对象。”

CESSetupProperty 枚举类型包含以下值：

这些值将具有以下含义：

ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY 属性是一个VT_BOOL值，该值指定服务器上下文是否为 ApplicationPoolIdentity。
ENUM_CESSETUPPROP_CACONFIG 属性包含证书颁发机构 (CA) 配置字符串 (VT_BSTR) 形式的 computerDNSname/CAName，其中 computerDNSname 是服务器的完全限定 DNS 名称，CAName 是 CA 的公用名称。
ENUM_CESSETUPPROP_AUTHENTICATION 属性指定使用的身份验证过程的类型。如果 GetProperty 方法成功返回， pPropertyValue 参数将包含以下常量之一：
- X509AuthKerberos
- X509AuthUsername
- X509AuthCertificate
ENUM_CESSETUPPROP_SSLCERTHASH 属性包含身份验证期间使用的证书的哈希 (VT_BSTR) 。 ENUM_CESSETUPPROP_AUTHENTICATION 属性必须设置为 X509AuthCertificate。
ENUM_CESSETUPPROP_URL 属性包含 CES 服务 URL。如果 GetProperty 方法成功返回， pPropertyValue 参数将包含 一个VT_BSTR 子类型，该子类型包含格式为“https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces”的 URL，其中身份验证类型可以是以下类型之一：
- Kerberos
- usernamepassword
- 证书 (certificate)
ENUM_CESSETUPPROP_RENEWALONLY 属性是一个VT_BOOL值，该值指定 CES 是否只能处理证书续订。