ICertificateEnrollmentServerSetup::SetProperty 方法 (casetup.h)
SetProperty 方法會指定憑證註冊 Web 服務 (CES) 組態的 CESSetupProperty 列舉值。
語法
HRESULT SetProperty(
[in] CESSetupProperty propertyId,
[in] VARIANT *pPropertyValue
);
參數
[in] propertyId
CESSetupProperty 列舉值,指定要擷取的屬性值。
[in] pPropertyValue
包含屬性值之 VARIANT 變數的指標。
傳回值
傳回碼 | Description |
---|---|
|
propertyId 自變數不是 CESSetupProperty 列舉類型的成員。
此外,如果您要設定 ENUM_CESSETUPPROP_AUTHENTICATION 屬性,則必須在 pPropertyValue 自變數中指定下列其中一個值:
|
|
pPropertyValue 參數不可為 NULL。 |
|
ICertificateEnrollmentServerSetup 物件尚未初始化。
ErrorString 屬性值會設定為 「安裝程序物件尚未初始化。 請使用 InitializeInstallDefaults 方法初始化安裝程式物件。」 |
|
如果您要設定 ENUM_CESSETUPPROP_AUTHENTICATION 屬性, VARIANT 子類型必須 VT_I2、 VT_I4或 VT_UI4。 |
備註
您必須先呼叫 InitializeInstallDefaults,才能呼叫 SetProperty。
您無法設定 ENUM_CESSETUPPROP_URL 屬性。
如果 WSEnrollmentServer 應用程式集區已經存在且已初始化 WMI,則無法設定 ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY 。
如果您要設定 ENUM_CESSETUPPROP_AUTHENTICATION 屬性, VARIANT 子類型必須是 VT_I2、 VT_I4 或 VT_UII4,而且 pPropertyValue 自變數必須是下列其中一個常數:
- X509AuthKerberos
- X509AuthUsername
- X509AuthCertificate
如果目標伺服器是獨立證書頒發機構單位,則無法設定ENUM_CESSETUPPROP_CACONFIG屬性。 ErrorString 屬性會設定為「憑證註冊 Web 服務無法與獨立證書頒發機構單位搭配使用 (CA) 。 它只能與企業 CA 搭配使用。」
.
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | casetup.h |
Dll | Certocm.dll |