Share via


ICertificateEnrollmentServerSetup::SetProperty 方法 (casetup.h)

SetProperty 方法會指定憑證註冊 Web 服務 (CES) 組態的 CESSetupProperty 列舉值。

語法

HRESULT SetProperty(
  [in] CESSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

參數

[in] propertyId

CESSetupProperty 列舉值,指定要擷取的屬性值。

[in] pPropertyValue

包含屬性值之 VARIANT 變數的指標。

傳回值

傳回碼 Description
E_INVALIDARG
propertyId 自變數不是 CESSetupProperty 列舉類型的成員。

此外,如果您要設定 ENUM_CESSETUPPROP_AUTHENTICATION 屬性,則必須在 pPropertyValue 自變數中指定下列其中一個值:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
E_POINTER
pPropertyValue 參數不可為 NULL
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
ICertificateEnrollmentServerSetup 物件尚未初始化。

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

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

備註

您必須先呼叫 InitializeInstallDefaults,才能呼叫 SetProperty

您無法設定 ENUM_CESSETUPPROP_URL 屬性。

如果 WSEnrollmentServer 應用程式集區已經存在且已初始化 WMI,則無法設定 ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY

如果您要設定 ENUM_CESSETUPPROP_AUTHENTICATION 屬性, VARIANT 子類型必須是 VT_I2VT_I4VT_UII4,而且 pPropertyValue 自變數必須是下列其中一個常數:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

如果目標伺服器是獨立證書頒發機構單位,則無法設定ENUM_CESSETUPPROP_CACONFIG屬性。 ErrorString 屬性會設定為「憑證註冊 Web 服務無法與獨立證書頒發機構單位搭配使用 (CA) 。 它只能與企業 CA 搭配使用。」

.

規格需求

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

另請參閱

ICertificateEnrollmentServerSetup