ICertificateEnrollmentPolicyServerSetup::SetProperty 方法 (casetup.h)
SetProperty方法會指定憑證註冊原則 (CEP) Web 服務組態的CEPSetupProperty列舉值。
語法
HRESULT SetProperty(
[in] CEPSetupProperty propertyId,
[in] VARIANT *pPropertyValue
);
參數
[in] propertyId
CEPSetupProperty列舉的值,指定要設定的屬性值。 下列值有效。
值 | Description |
---|---|
ENUM_CEPSETUPPROP_AUTHENTICATION | pPropertyValue參數包含值,可識別要使用的驗證類型。 |
ENUM_CEPSETUPPROP_SSLCERTHASH | pPropertyValue參數包含憑證的雜湊,如果有的話,在驗證期間使用。 ENUM_CEPSETUPPROP_AUTHENTICATION 必須設定為 X509AuthCertificate。 |
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL | pPropertyValue參數指定是否要在傳回 KeyBasedRenewal 範本原則的模式中設定註冊原則伺服器。 |
ENUM_CEPSETUPPROP_URL | 您無法指定此值。 |
[in] pPropertyValue
包含屬性值之 VARIANT 變數的指標。
如果您在propertyId參數中指定ENUM_CEPSETUPPROP_AUTHENTICATION,VARIANT子類型必須是VT_I2、VT_I4或VT_UII4,而pPropertyValue引數必須是下列其中一個常數:
- X509AuthKerberos
- X509AuthUsername
- X509AuthCertificate
如果您在propertyId參數中指定ENUM_CEPSETUPPROP_SSLCERTHASH,則必須將pPropertyValue參數設定為包含用於驗證之憑證雜湊的VT_BSTR子類型。
如果您在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列舉類型的成員,或您嘗試設定ENUM_CEPSETUPPROP_URL值。 |
|
pPropertyValue參數不可為Null。 |
|
ICertificateEnrollmentPolicyServerSetup物件尚未初始化。
ErrorString屬性值會設定為 「安裝程式物件尚未初始化。 請使用 InitializeInstallDefaults 方法初始化安裝程式物件。」 |
|
如果您要設定 ENUM_CEPSETUPPROP_AUTHENTICATION 屬性, VARIANT 子類型必須 VT_I2、 VT_I4或 VT_UI4。 |
備註
您必須先呼叫 InitializeInstallDefaults ,才能呼叫 SetProperty 方法。
規格需求
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | casetup.h |
Dll | Certocm.dll |