共用方式為


ICertificateEnrollmentPolicyServerSetup::GetProperty 方法 (casetup.h)

GetProperty 方法會擷取憑證註冊原則 (CEP) Web 服務組態的 CEPSetupProperty 列舉值。

語法

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

參數

[in] propertyId

CEPSetupProperty 列舉的值,指定要設定的屬性值。 下列值有效。

Description
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,pPropertyValue 參數會包含VT_BSTR子類型,如果 GetProperty 方法成功傳回,則會包含哈希。

如果您在 propertyId 參數中指定ENUM_CEPSETUPPROP_AUTHENTICATION,pPropertyValue 參數會包含驗證程式。

如果您在 propertyId 參數中指定ENUM_CEPSETUPPROP_URL,pPropertyValue 參數會包含憑證註冊原則 (CEP) Web 服務 URL。

如果您在 propertyId 參數中指定ENUM_CEPSETUPPROP_KEYBASED_RENEWAL,則必須將 pPropertyValue 參數設定為VT_BOOL子類型,指出是否在傳回 KeyBasedRenewal 範本原則的模式中設定註冊原則伺服器。

傳回值

傳回碼 Description
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