RequestStateChange method of the CIM_VirtualSystemManagementService class
Requests the specified change to the state of the element.
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 requested state for the element.
The possible values are.
-
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 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
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2016 |
| Namespace |
Root\HyperVCluster\v2 |
| MOF |
|
| DLL |
|