Метод Msvm_CopyFileToGuestJob::RequestStateChange

Статья
06/13/2023

Изменяет состояние задания.

Синтаксис

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

Параметры

RequestedState [in]: Новое состояние. Возможные значения:
Начало (2): Изменяет состояние на "Выполняется".
Приостановка (3): Временно останавливает задание. Затем клиент может перезапустить задание с помощью команды Start. Клиент может перейти в состояние "Служба" во время приостановки (это зависит от задания).
Завершение (4): Останавливает задание в чистом виде, сохраняя данные, сохраняя состояние и завершая все базовые процессы упорядоченным образом.
Kill (5): Немедленно завершает задание без необходимости сохранять данные или сохранять состояние.
Служба (6): Переводит задание в состояние службы, зависят от поставщика. Клиент может перезапустить задание.
DmTF Reserved (7..32767)
Зарезервировано поставщиком (32768..65535)

TimeoutPeriod [in]

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

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

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

Возвращаемый код/значение	Описание
Завершено без ошибок 0	Успешно.
Использование параметра timeout не поддерживается 4098
Сбой 32768
доступ запрещен 32769	Доступ запрещен.
Не поддерживается 32770
Состояние неизвестно 32771
Timeout 32772
недопустимый параметр. 32773
Система используется 32774
Недопустимое состояние для этой операции 32775	Значение, указанное в параметре RequestedState , не поддерживается.
Неправильный тип данных 32776
Система недоступна 32777
Недостаточно памяти 32778

Требования

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

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

Msvm_CopyFileToGuestJob

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