RequestStateChange method of the MSFT_PCSVDevice class

  • Article

Requests that the state of the physical computer system be changed to the specified value. Implemented. Invoking this method multiple times could result in earlier requests being overwritten or lost.

Syntax

uint32 RequestStateChange(
  [in]      uint16              RequestedState,
  [in, out] CIM_ConcreteJob REF Job,
  [in]      datetime            TimeoutPeriod
);

Parameters

RequestedState [in]

Specifies the state requested for the physical computer system.

Enabled (2)

Disabled (3)

Shut Down (4)

Offline (6)

Test (7)

Defer (8)

Quiesce (9)

Reboot (10)

Reset (11)

DMTF Reserved

12 32767

Vendor Reserved

32768 65535

Job [in, out]

On return contains a reference to the job, but can be null if the task is completed.

TimeoutPeriod [in]

Specifies the maximum amount of time that the client expects the transition to the new state to take. The timeout must be specified using the datetime interval format.

A value of zero or NULL indicates that the client has no time requirements for the transition. If this property does not contain zero 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

This method returns one of the following values.

Completed with No Error (0)

Not Supported (1)

Failed (2)

Reserved (3 4095)

Job Started (4096)

DMTF Reserved (4097 32767)

Vendor Reserved (32768 65535)

Requirements
Minimum supported client
 Windows 8.1
Minimum supported server
 Windows Server 2012 R2
Namespace
 Root\Microsoft\Windows\HardwareManagement
MOF
PCSVDevice.mof
DLL
PCSVDevice.dll

See also

MSFT_PCSVDevice