RequestStateChange method of the MSFT_DNSClientServerAddress class

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

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

MSFT_DNSClientServerAddress