RequestStateChange method of the CIM_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 REF Job,
[in] datetime TimeoutPeriod
);
Parameters
-
RequestedState [in]
-
The state requested for the element. This information will be placed into the instance's RequestedState property if the RequestStateChange method's return code is 0, 3, or 4096 (0x1000) - Completed with No Error, Timeout, or Job Started respectively. Refer to the description of the EnabledState and RequestedState properties for the detailed meanings of the RequestedState values.
-
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]
Reference to the job (may be null if task completed).
TimeoutPeriod [in]
A timeout period that specifies the maximum amount of time that the client expects the transition to the new state to take. The interval format MUST be used to specify the TimeoutPeriod. A value of 0 or a null parameter indicates that the client has no time requirements for the transition.
If this property does not contain 0 or null and the implementation doesn't support this parameter. A return code of 'Use Of Timeout Parameter Not Supported' MUST be returned.
Return value
-
Completed with No Error (0)
-
Not Supported (1)
-
Unknown/Unspecified Error (2)
-
Can NOT 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
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\Hardware |
| MOF |
|
| DLL |
|