RequestStateChange method of the CIM_PhysicalComputerSystemView class

An extrinsic method for changing the state of this physical computer system. Requests that the state of the element be changed to the value specified in the RequestedState parameter. When the requested state change takes place, the EnabledState and RequestedState will be the same. Invoking the RequestStateChange method multiple times could result in earlier requests being overwritten or lost.A return code of 0 shall indicate the state change was successfully initiated.A return code of 1 shall indicate that the method is not supported. A return code of 2 shall indicate that the method failed.A return code of 4096 shall indicate the state change was successfully initiated, a ConcreteJob has been created, and its reference returned in the output parameter Job.

Syntax

uint32 RequestStateChange(
  [in]      uint16              RequestedState,
  [in, out] CIM_ConcreteJob REF Job,
  [in]      datetime            TimeoutPeriod
);

Parameters

RequestedState [in]

See CIM_ComputerSystem.RequestedStateChange.RequestedState for details.

Enabled (2)

Disabled (3)

Shut Down (4)

Offline (6)

Test (7)

Defer (8)

Quiesce (9)

Reboot (10)

Reset (11)

DMTF Reserved

12 32767

Vendor Reserved

32768 65535

Job [in, out]

May contain a reference to the ConcreteJob created to track the state transition initiated by the method invocation.

TimeoutPeriod [in]

See CIM_ComputerSystem.TimeoutPeriod for details.

Return value

Completed with No Error (0)

Not Supported (1)

Failed (2)

Job Started (4096)

DMTF Reserved (4097 32767)

Vendor Reserved (32768 65535)

Requirements

Minimum supported client	Windows 8.1
Minimum supported server	Windows Server 2012 R2
Namespace	Root\Microsoft\Windows\HardwareManagement
MOF	Pcsvdevice.mof
DLL	PCSVdevice.dll

See also

CIM_PhysicalComputerSystemView