CIM_LogicalDevice類別的 EnableDevice 方法(Hyper-V)

EnableDevice 方法已被棄用,取而代之的是更通用的 RequestStateChange 方法,該方法與該方法的功能直接重疊。

請求啟用邏輯裝置(「啟用」輸入參數=TRUE)或停用(=FALSE)。 如果成功,裝置的 StatusInfo/EnabledState 屬性應該會反映想要的狀態(啟用/停用)。 請注意,此方法的功能與 RequestedState 屬性重疊。 RequestedState 被加入模型中,以維護最後一次狀態請求的紀錄(即持久值)。 呼叫 EnableDevice 方法應該會適當設定 RequestedState 屬性。

如果請求成功執行,回傳碼應為 0;若請求未被支援為 1;若發生錯誤則為其他值。 在子類別中,可透過方法上的 ValueMap 限定符指定可能的回傳碼集合。 ValueMap 內容被「翻譯」的字串也可以在子類別中指定為 Values 陣列的限定符。

語法

uint32 EnableDevice(
  [in] boolean Enabled
);

參數

啟用 [in]

如果是 TRUE,則啟用該裝置;如果是 FALSE,則停用該裝置。

返回值

成功時會回傳0分;否則,會回傳錯誤。

要求

需求 價值
最低支援的用戶端
Windows 8.1
最低支援的伺服器
Windows Server 2012 R2
命名空間
根\虛擬化\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另請參閱

CIM_LogicalDevice