RequestStateChange method of the ComputerSystem class

Initiates a requests to change the state of a computer system.

This method is inherited from CIM_EnabledLogicalElement.

Syntax

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

Parameters

RequestedState [in]

The new state to request.

2

Enabled

3

Disabled

4

Shut Down

6

Offline

7

Test

8

Defer

9

Quiesce

10

Reboot

11

Reset

12 32767

DMTF Reserved

32768 65535

Vendor Reserved

Job [out]

A concrete job that tracks the state transition initiated by this operation.

TimeoutPeriod [in]

The timeout period that specifies the maximum amount of time to use to transition to the new state.

Return value

A return code that indicates whether the operation completed successfully.

0

Completed with No Error

1

Not Supported

2

Unknown or Unspecified Error

3

Cannot complete within Timeout Period

4

Failed

5

Invalid Parameter

6

In Use

7 4095

DMTF Reserved

4096

Method Parameters Checked - Job Started

4097

Invalid State Transition

4098

Use of Timeout Parameter Not Supported

4099

Busy

4100 32767

Method Reserved

32768 65535

Vendor Specific

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\hardware
MOF
IpmiPrv.mof
DLL
IpmiPrv.dll

See also

IPMI Provider

ComputerSystem