Метод Msvm_GuestService::RequestStateChange

Статья
06/13/2023

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

Синтаксис

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

Параметры

RequestedState [in]: Новое состояние. Сведения помещаются в свойство RequestedState экземпляра, если код возврата метода RequestStateChange равен 0 или 4096. Дополнительные сведения см. в описании свойств EnabledState и RequestedState для элемента . Это должно быть одно из следующих значений.
Включено (2)
Отключено (3)
Завершение работы (4)
В автономном режиме (6)
Тест (7)
Отложить (8)
Замораживая (9)
Перезагрузка (10)
Сброс (11)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (32768..65535)

Задание [out]

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

TimeoutPeriod [in]

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

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

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

Возвращаемый код или значение	Описание
Завершено без ошибок 0	Успешно.
Не поддерживается 1
Проверенные параметры метода — переход запущен 4096	Переход является асинхронным.
Использование параметра timeout не поддерживается 4098
доступ запрещен 32769	Доступ запрещен.
Недопустимое состояние для этой операции 32775	Значение, указанное в параметре RequestedState , не поддерживается.

Требования

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

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

Msvm_GuestService

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