RequestStateChange method of the CIM_ConcreteJob 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.
Important The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.
- RequestedState [in]
The new state of a job.
- 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.
This method returns one of the following values.
- Completed with No Error (0)
- Not Supported (1)
- Unknown/Unspecified Error (2)
- Cannot complete within Timeout Period (3)
- Failed (4)
- Invalid Parameter (5)
- In Use (6)
- DMTF Reserved (..)
- Method Parameters Checked - Transition Started (4096)
- Invalid State Transition (4097)
- Use of Timeout Parameter Not Supported (4098)
- Busy (4099)
- Method Reserved (4100..32767)
- Vendor Specific (32768..65535 )