Initiates a requests to change the state of a DNS server interface.
This method is inherited from CIM_EnabledLogicalElement.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
Parameters
RequestedState [in]
The new state to request.
| Value | Meaning |
|---|---|
| 2 | Enabled |
| 3 | Disabled |
| 4 | Shut Down |
| 6 | Offline |
| 7 | Test |
| 8 | Defer |
| 9 | Quiesce |
| 10 | Reboot |
| 11 | Reset |
| 12 32767 | DMTF Reserved |
| 32768 65535 | Vendor Reserved |
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.
| Return value | Description |
|---|---|
| 0 | Completed with No Error |
| 1 | Not Supported |
| 2 | Unknown or Unspecified Error |
| 3 | Cannot complete within Timeout Period |
| 4 | Failed |
| 5 | Invalid Parameter |
| 6 | In Use |
| 7 4095 | DMTF Reserved |
| 4096 | Method Parameters Checked - Job Started |
| 4097 | Invalid State Transition |
| 4098 | Use of Timeout Parameter Not Supported |
| 4099 | Busy |
| 4100 32767 | Method Reserved |
| 32768 65535 | Vendor Specific |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Namespace | Root\StandardCimV2 |
| MOF | DnsClientCim.mof |
| DLL | DnsClientCim.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors (upstream author metadata: windowssdkdev). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
