共用方式為

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
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

這些值具有以下意義：

  • 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 是否只能處理憑證更新。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 casetup.h
Dll Certocm.dll

另請參閱

ICertificateEnrollmentServerSetup