RequestStateChange method of the MSFT_DNSClient class

  • Article

Initiates a requests to change the state of a DNS client.

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_DNSClient