RequestStateChange method of the Msps_ProvisioningJob class
Requests that the state of the job be changed to the value specified in the RequestedState parameter. Invoking the RequestStateChange method multiple times could result in earlier requests being overwritten or lost.
If 0 is returned, then the task completed successfully. Any other return code indicates an error condition.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Parameters
-
RequestedState [in]
-
The requested state for the job.
-
2
-
Start - changes the state to 'Running'.
-
3
-
Suspend - stops the job temporarily. The intention is to subsequently restart the job with 'Start'. It might be possible to enter the 'Service' state while suspended. (This is job-specific.)
-
4
-
Terminate - stops the job cleanly, saving data, preserving the state, and shutting down all underlying processes in an orderly manner.
-
5
-
Kill - terminates the job immediately with no requirement to save data or preserve the state.
-
6
-
Service - puts the job into a vendor-specific service state. It might be possible to restart the job.
-
7 32767
-
DMTF Reserved
-
32768 65535
-
Vendor Reserved
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 does not support this parameter, a return code of 'Use Of Timeout Parameter Not Supported' must be returned.
Return value
-
0
Completed with No Error
-
1
Not Supported
-
2
Unknown/Unspecified Error
-
3
Can NOT complete within Timeout Period
-
4
Failed
-
5
Invalid Parameter
-
6
In Use
-
7 4095
DMTF Reserved
-
4096
Method Parameters Checked - Transition 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 |
None supported |
| Minimum supported server |
Windows Server 2016 |
| Namespace |
Root\MSPS |
| MOF |
|
| DLL |
|