Метод Msvm_GuestServiceInterfaceComponent::RequestStateChange

Статья
06/13/2023

Запрашивает изменение состояния компонента интерфейса гостевой службы на указанное значение.

Синтаксис

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

Параметры

RequestedState [in]

Тип: uint16

Новое состояние. Сведения помещаются в свойство RequestedState экземпляра, если код возврата метода RequestStateChange равен 0 или 4096. Дополнительные сведения см. в описании свойств EnabledState и RequestedState для элемента . Это должно быть одно из следующих значений.

Включено (2)

Отключено (3)

Завершение работы (4)

В автономном режиме (6)

Тест (7)

Отложить (8)

Замораживая (9)

Перезагрузка (10)

Сброс (11)

Зарезервировано DMTF (..)

Зарезервировано поставщиком (32768..65535)

Задание [out]

Тип: CIM_ConcreteJob

Необязательная ссылка на объект Msvm_ConcreteJob , который возвращается, если операция выполняется асинхронно. Если она есть, возвращаемую ссылку можно использовать для отслеживания хода выполнения и получения результата метода .

TimeoutPeriod [in]

Тип: datetime

Период времени ожидания, указывающий максимальное время, в течение которого клиент ожидает переход в новое состояние. Формат интервала должен использоваться для указания периода ожидания. Значение 0 или Null указывает, что у клиента нет временных требований для перехода. Если это свойство не содержит 0 или Null , а реализация не поддерживает этот параметр, необходимо вернуть код возврата 4098 (Параметр времени ожидания не поддерживается).

Возвращаемое значение

Тип: uint32

Этот метод возвращает одно из следующих значений.

Возвращаемый код или значение	Описание
Завершено без ошибок 0	Успешно.
Не поддерживается 1
Неизвестная/неуказаемая ошибка 2
Не может завершиться в течение периода ожидания 3
Сбой 4
Недопустимый параметр 5
Используется 6
Зарезервировано DMTF ..
Проверенные параметры метода — переход запущен 4096
Недопустимый переход состояния 4097
Использование параметра timeout не поддерживается 4098
Занят 4099
Зарезервированный метод 4100..32767
Конкретный поставщик 32768..65535

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 R2 [только классические приложения]
Пространство имен	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

См. также раздел

Msvm_GuestServiceInterfaceComponent

Поделиться через