EnableDevice-Methode der CIM_LogicalDevice-Klasse (Hyper-V)

Die EnableDevice-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 aktiviert werden ("Enabled"-Eingabeparameter = 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 überlappt. RequestedState wurde dem Modell hinzugefügt, um einen Datensatz (d. h. einen dauerhaften Wert) der letzten Statusanforderung zu verwalten. Das Aufrufen der EnableDevice-Methode sollte die RequestedState-Eigenschaft entsprechend festlegen.

Der Rückgabecode sollte 0 sein, wenn die Anforderung erfolgreich ausgeführt wurde, 1, wenn die Anforderung nicht unterstützt wird, und einen anderen 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 der ValueMap-Inhalt übersetzt wird, kann auch in der Unterklasse als Wertearrayqualifizierer angegeben werden.

Syntax

uint32 EnableDevice(
  [in] boolean Enabled
);

Parameter

Aktiviert [in]

Wenn TRUE das Gerät aktiviert, wenn FALSE das Gerät deaktiviert.

Zurückgegebener Wert

Gibt eine 0 bei Erfolg zurück; andernfalls wird ein Fehler zurückgegeben.

Anforderungen

Siehe auch

CIM_LogicalDevice