CIM_LogicalDevice 類別的 OnlineDevice 方法
OnlineDevice 方法已被取代，而不是與此方法所提供的功能直接重疊的較一般 RequestStateChange 方法。
要求將 LogicalDevice 帶上線（“Online” 輸入參數 = TRUE）或離線 （= FALSE）。 「在線」表示裝置已準備好接受要求，且運作正常。 在此情況下，Device\'s Availability 屬性會設定為 3 值（「執行/完整電源」）。 「離線」表示裝置已啟動且可運作，但無法處理功能要求。 處於離線狀態，裝置可能能夠執行診斷或產生操作警示。 例如，當 [印表機] 上按下 [離線] 按鈕時，裝置就無法再處理印表作業，但可用於診斷或維護。
如果此方法成功，Device\'s Availability and AdditionalAvailability 屬性應該會反映更新的狀態。 如果嘗試讓裝置上線或離線時發生失敗，它應該保持其目前狀態。 IE，若未成功，則要求不應讓裝置處於不確定狀態。 從「離線」模式將裝置帶回「在線」時，如果可能的話，裝置應該還原到其最後一個「在線」狀態。 只有 EnabledState/StatusInfo 為 “Enabled” 且已設定的裝置可以上線或離線。
如果成功，OnlineDevice 應該傳回 0;如果完全不支援要求，則傳回 1;如果要求因裝置的目前狀態而不受支援，則傳回 1;如果發生任何其他錯誤，則傳回 2。 在子類別中，可以使用 方法上的 ValueMap 限定符來指定一組可能的傳回碼。 ValueMap 內容為 \'translated\' 的字串也可以在子類別中指定為 Values 陣組限定符。
請注意，這個方法的 函式會與 RequestedState 屬性重疊。 RequestedState 已新增至模型，以維護最後一個狀態要求的記錄（亦即保存值）。 叫用 OnlineDevice 方法應該適當地設定 RequestedState 屬性。
語法
uint32 OnlineDevice(
[in] boolean Online
);
參數
-
在線 [in]
-
如果為 TRUE，請讓裝置上線，如果為 FALSE，請讓裝置離線。
傳回值
待定
需求
| 最低支援的用戶端 |
Windows 8 |
| 最低支援的伺服器 |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|