大网数据广告活动
Hyper-V与虚拟化

Msvm_GuestServiceInterfaceComponent::RequestStateChange method

· 52CE 我爱测

Requests that the state of the guest service interface component be changed to the specified value.

Requests that the state of the guest service interface component be changed to the specified value.

Syntax

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

Parameters

RequestedState [in]

Type: uint16

The new state. The info is placed in the RequestedState property of the instance if the return code of the RequestStateChange method is 0 or 4096. For more info, see the description of the EnabledState and RequestedState properties for the element. This must be one of the following values.

Enabled (2)

Disabled (3)

Shut Down (4)

Offline (6)

Test (7)

Defer (8)

Quiesce (9)

Reboot (10)

Reset (11)

DMTF Reserved (..)

Vendor Reserved (32768..65535)

Job [out]

Type: CIM_ConcreteJob

An optional reference to a Msvm_ConcreteJob object that is returned if the operation is executed asynchronously. If present, the returned reference can be used to monitor progress and obtain the result of the method.

TimeoutPeriod [in]

Type: datetime

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 timeout period. A value of 0 or Null 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 4098 (Use Of Timeout Parameter Not Supported) must be returned.

Return value

Type: uint32

This method returns one of the following values.

Return code/value Description
Completed with No Error 0 Success.
Not supported 1
Unknown/Unspecified Error 2
Can NOT 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

Requirements

Requirement Value
Minimum supported client Windows 8.1 [desktop apps only]
Minimum supported server Windows Server 2012 R2 [desktop apps only]
Namespace \\Root\Virtualization\V2
MOF WindowsVirtualization.V2.mof
DLL Vmms.exe

See also

Msvm_GuestServiceInterfaceComponent

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。