Метод RequestStateChange класса CIM_ConcreteJob

Статья
06/13/2023

Запрашивает изменение состояния задания на значение, указанное в параметре RequestedState. Несколько раз вызов метода RequestStateChange может привести к перезаписи или потере более ранних запросов.

Если возвращается значение 0, задача успешно завершена. Любой другой код возврата указывает на условие ошибки.

Синтаксис

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

Параметры

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

TimeoutPeriod [in]

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

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

Возвращает значение 0 при успешном выполнении; в противном случае возвращает ошибку.

Завершено без ошибок (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

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

CIM_ConcreteJob

Share via