共用方式為


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_AUTHENTICATIONVARIANT子類型必須是VT_I2VT_I4VT_UII4,而pPropertyValue引數必須是下列其中一個常數:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

如果您在propertyId參數中指定ENUM_CEPSETUPPROP_SSLCERTHASH,則必須將pPropertyValue參數設定為包含用於驗證之憑證雜湊的VT_BSTR子類型。

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

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

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

傳回值

傳回碼 Description
E_INVALIDARG
propertyId引數不是CEPSetupProperty列舉類型的成員,或您嘗試設定ENUM_CEPSETUPPROP_URL值。
E_POINTER
pPropertyValue參數不可為Null
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
ICertificateEnrollmentPolicyServerSetup物件尚未初始化。

ErrorString屬性值會設定為 「安裝程式物件尚未初始化。 請使用 InitializeInstallDefaults 方法初始化安裝程式物件。」

HRESULT_FROM_WIN32 (ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
如果您要設定 ENUM_CEPSETUPPROP_AUTHENTICATION 屬性, VARIANT 子類型必須 VT_I2VT_I4VT_UI4

備註

您必須先呼叫 InitializeInstallDefaults ,才能呼叫 SetProperty 方法。

規格需求

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

另請參閱

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults