Метод RequestStateChange класса CIM_ConcreteJob
Запрашивает изменение состояния задания на значение, указанное в параметре 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 |
|
DLL |
|