RequestStateChange method of the CIM_EnabledLogicalElement 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 REF Job,
[in] datetime TimeoutPeriod
);
Parameters
-
RequestedState [in]
-
The new state to request.
-
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 [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.
-
Completed with No Error
-
0
-
Not Supported
-
1
-
Unknown/Unspecified Error
-
2
Unknown or Unspecified Error
-
Can NOT complete within Timeout Period
-
3
Cannot complete within Timeout Period
-
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
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\Hardware |
| MOF |
|
| DLL |
|