Share via


RequestStateChange method of the CIM_EnabledLogicalElement class

Requests the specified change to the state of the element.

Syntax

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

Parameters

RequestedState [in]

The requested state for the element.

The possible values are.

Enabled (2)

Disabled (3)

Shut Down (4)

No Change (5)

Offline (6)

Test (7)

Deferred (8)

Quiesce (9)

Reboot (10)

Reset (11)

Not Applicable (12)

DMTF Reserved

13 32767

Vendor Reserved

32768 65535

Job [out]

A reference to the job created to track the state transition initiated by the method invocation.

TimeoutPeriod [in]

The client specified timeout interval for the length of the state transition. A 0 or a null value indicates that the client has no time requirements for the transition. If this property does not contain 0 or null and the implementation does not support this parameter, this method returns 4098 (Use Of Timeout Parameter Not Supported).

Return value

Completed with No Error (0)

Not Supported (1)

Unknown or Unspecified Error (2)

Cannot complete within Timeout Period (3)

Failed (4)

Invalid Parameter (5)

In Use (6)

DMTF Reserved (7 4095)

Method Parameters Checked - Job Started (4096)

Invalid State Transition (4097)

Use of Timeout Parameter Not Supported (4098)

Busy (4099)

Method Reserved (4100 32767)

Vendor Specific (32768 65535)

Requirements

Namespace
Root\virtualization
MOF
WindowsVirtualization.mof

See also

CIM_EnabledLogicalElement