OnlineDevice-Methode der CIM_LogicalDevice-Klasse
Die OnlineDevice-Methode ist anstelle der allgemeineren RequestStateChange-Methode veraltet, die sich direkt mit der von dieser Methode bereitgestellten Funktionalität überlappt.
Fordert an, dass die LogicalDevice online gebracht werden ("Online"-Eingabeparameter = TRUE) oder offline (= FALSCH). "Online" gibt an, dass das Gerät bereit ist, Anforderungen zu akzeptieren und betriebsbereit und voll funktionsfähig ist. In diesem Fall wird die Verfügbarkeitseigenschaft "Device\" auf den Wert 3 ("Running/Full Power") festgelegt. "Offline" gibt an, dass ein Gerät eingeschaltet und betriebsbereit ist, aber keine funktionalen Anforderungen verarbeitet. In einem Offlinezustand kann ein Gerät Diagnosen ausführen oder Betriebswarnungen generieren. Wenn z. B. die Schaltfläche "Offline" auf einem Drucker gedrückt wird, ist das Gerät nicht mehr für die Verarbeitung von Druckaufträgen verfügbar, kann aber für Diagnosen oder Wartungen verfügbar sein.
Wenn diese Methode erfolgreich ist, sollten die Eigenschaften "Verfügbarkeit" und "AdditionalAvailability" den aktualisierten Status widerspiegeln. Wenn ein Fehler auftritt, der versucht, das Gerät online oder offline zu bringen, sollte es im aktuellen Zustand bleiben. IE, die Anforderung, falls nicht erfolgreich, sollte das Gerät nicht in einem unbestimmten Zustand belassen. Wenn ein Gerät aus einem Offlinemodus wieder "Online" zurückgesetzt wird, sollte das Gerät ggf. in den letzten Status "Online" wiederhergestellt werden. Nur ein Gerät, das über einen EnabledState/StatusInfo von "Enabled" verfügt und konfiguriert wurde, kann online gebracht oder offline geschaltet werden.
OnlineDevice sollte bei erfolgreicher Ausführung 0 zurückgeben, 1, wenn die Anforderung überhaupt nicht unterstützt wird, 2, wenn die Anforderung aufgrund des aktuellen Zustands des Geräts nicht unterstützt wird, und einen anderen Wert, wenn ein anderer Fehler aufgetreten ist. In einer Unterklasse kann der Satz möglicher Rückgabecodes mithilfe eines ValueMap-Qualifizierers für die Methode angegeben werden. Die Zeichenfolgen, für die der ValueMap-Inhalt "\"translated\" ist, kann auch in der Unterklasse als Wertearrayqualifizierer angegeben werden.
Beachten Sie, dass sich die Funktion dieser Methode mit der RequestedState-Eigenschaft überlappt. RequestedState wurde dem Modell hinzugefügt, um einen Datensatz (d. h. einen dauerhaften Wert) der letzten Statusanforderung zu verwalten. Das Aufrufen der OnlineDevice-Methode sollte die RequestedState-Eigenschaft entsprechend festlegen.
Syntax
uint32 OnlineDevice(
[in] boolean Online
);
Parameter
-
Online- [in]
-
Wenn WAHR, nehmen Sie das Gerät online, wenn FALSE, das Gerät OFFLINE.
Rückgabewert
TBD
Anforderungen
| Mindestens unterstützter Client |
Windows 8 |
| Mindestens unterstützter Server |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|