EnableDevice-Methode der CIM_LogicalDevice-Klasse
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 |
|
| DLL |
|