EnableDevice-Methode der CIM_LogicalDevice-Klasse

Artikel
06/13/2023

Die EnableDevice-Methode wurde anstelle der allgemeineren RequestStateChange-Methode veraltet, die sich direkt mit der funktionalität dieser Methode überschneidet.

Fordert an, dass das LogicalDevice aktiviert ("Enabled" input parameter = TRUE) oder deaktiviert (= FALSE). Bei erfolgreicher Ausführung sollten die StatusInfo/EnabledState-Eigenschaften des Geräts den gewünschten Zustand (aktiviert/deaktiviert) widerspiegeln. Beachten Sie, dass sich die Funktion dieser Methode mit der RequestedState-Eigenschaft überschneidet. RequestedState wurde dem Modell hinzugefügt, um einen Datensatz (d. h. einen dauerhaften Wert) der letzten Zustandsanforderung zu verwalten. Beim Aufrufen der EnableDevice-Methode sollte die RequestedState-Eigenschaft entsprechend festgelegt werden.

Der Rückgabecode sollte 0 sein, wenn die Anforderung erfolgreich ausgeführt wurde, 1, wenn die Anforderung nicht unterstützt wird, und ein anderer Wert, wenn ein 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, in die die ValueMap-Inhalte übersetzt werden, können auch in der Unterklasse als Value-Arrayqualifizierer angegeben werden.

Syntax

uint32 EnableDevice(
  [in] boolean Enabled
);

Parameter

Aktiviert [in]: Wenn TRUE aktiviert ist, aktivieren Sie das Gerät, wenn FALSE das Gerät deaktiviert.

Rückgabewert

Gibt bei Erfolg eine 0 zurück; Gibt andernfalls einen Fehler zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Namespace	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

CIM_LogicalDevice

Freigeben über