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,其中驗證類型可以是下列其中一項:
|
[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 |
---|---|
|
propertyId 自變數不是 CEPSetupProperty 列舉類型的成員。 |
|
pPropertyValue 參數不可為 NULL。 |
|
ICertificateEnrollmentPolicyServerSetup 物件尚未初始化。
ErrorString 屬性值會設定為 「安裝程序物件尚未初始化。 請使用 InitializeInstallDefaults 方法初始化安裝程式物件。」 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | casetup.h |
Dll | Certocm.dll |