Methode OnlineDevice der Klasse CIM_LogicalPort
Die OnlineDevice-Methode wurde als veraltet eingestuft zugunsten der allgemeineren RequestStateChange-Methode, die sich unmittelbar mit der von dieser Methode bereitgestellten Funktionalität überlappt.
Fordert an, dass das LogicalDevice online („Online“-Eingabeparameter = WAHR) oder offline (= FALSCH) gebracht wird. „Online“ gibt an, dass das Gerät bereit ist, Anforderungen zu akzeptieren und betriebsbereit sowie voll funktionsfähig ist. In diesem Fall wird die Verfügbarkeitseigenschaft des Geräts auf den Wert 3 („In Betrieb/Nennleistung“) festgelegt. „Offline“ gibt an, dass ein Gerät eingeschaltet und betriebsbereit ist, aber keine funktionalen Anforderungen verarbeitet. Im 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 verfügbar, um Druckaufträge zu verarbeiten, kann aber für Diagnose oder Wartung verfügbar sein.
Wenn diese Methode erfolgreich ist, sollten die Eigenschaften Availability und AdditionalAvailability den aktualisierten Status widerspiegeln. Wenn ein Fehler auftritt, der versucht, das Gerät online oder offline zu schalten, sollte es in seinem aktuellen Zustand verbleiben. Eine nicht erfolgreiche Anforderung sollte also das Gerät nicht in einem unbestimmten Zustand belassen. Wenn ein Gerät aus dem Offlinemodus wieder online geschaltet wird, sollte ggf. der letzte Onlinestatus des Geräts wiederhergestellt werden. Nur ein Gerät, für das EnabledState/StatusInf“ auf „Enabled“ festgelegt und konfiguriert wurde, kann online 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 Status 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-Kennzeichners für die Methode angegeben werden. Die Zeichenfolgen, für die der ValueMap-Inhalt „translated“ lautet, kann auch in der Unterklasse als Wertearraykennzeichner angegeben werden.
Beachten Sie, dass 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 beizubehalten. Das Aufrufen der OnlineDevice-Methode muss die RequestedState-Eigenschaft entsprechend festlegen.
Syntax
uint32 OnlineDevice(
[in] boolean Online
);
Parameter
-
Online [in]
-
Wenn WAHR, nehmen Sie das Gerät online, wenn FALSCH, nehmen Sie das Gerät OFFLINE.
Rückgabewert
TBD
Anforderungen
| Unterstützte Mindestversion (Client) |
Windows 8 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|