ICertificateEnrollmentServerSetup：：GetProperty 方法 (casetup.h)

GetProperty 方法會擷取憑證註冊 Web 服務 (CES) 組態的 CESSetupProperty 列舉值。

語法

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

[in] propertyId

CESSetupProperty 列舉值，指定要擷取的屬性值。如需詳細資訊，請參閱＜備註＞。

[out] pPropertyValue

包含屬性值之 VARIANT 變數的指標。

傳回碼	Description
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 是否只能處理憑證更新。