Метод RequestStateChange класса Msvm_ConcreteJob
Запрашивает изменение состояния задания на указанное. Несколько раз вызов метода RequestStateChange может привести к перезаписи или потере более ранних запросов. Если возвращается значение 0, задача успешно завершена. Любой другой код возврата указывает на условие ошибки.
Синтаксис
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Параметры
-
RequestedState [in]
-
Тип: uint16
Новое состояние задания.
-
Начало (2)
-
Изменяет состояние на "Выполняется".
-
Приостановка (3)
-
Временно останавливает задание. Цель состоит в том, чтобы впоследствии перезапустить задание с параметром "Start". Во время приостановки можно перейти в состояние "Служба". (Это зависит от задания.)
-
Завершить (4)
-
Останавливает задание без изменений, сохраняет данные, сохраняет состояние и завершает все базовые процессы упорядоченным образом.
-
Kill (5)
-
Немедленно завершает задание без необходимости сохранять данные или сохранять состояние.
-
Служба (6)
-
Переводит задание в состояние службы, зависят от поставщика. Возможно, можно перезапустить задание.
-
Зарезервировано DMTF
-
Зарезервировано.
-
Зарезервировано поставщиком
-
Зарезервировано.
TimeoutPeriod [in]
Тип: datetime
Период времени ожидания, указывающий максимальное время, в течение которого клиент ожидает переход в новое состояние. Формат интервала должен использоваться для указания периода ожидания. Значение 0 или Null указывает, что у клиента нет временных требований для перехода. Если это свойство не содержит 0 или Null , а реализация не поддерживает этот параметр, необходимо вернуть код возврата 4098 (Параметр времени ожидания не поддерживается).
Возвращаемое значение
Тип: uint32
Этот метод возвращает одно из следующих значений.
-
Завершено без ошибок (0)
-
Не поддерживается (1)
-
Неизвестная/неуказаемая ошибка (2)
-
Не удается завершить в течение периода ожидания (3)
-
Сбой (4)
-
Недопустимый параметр (5)
-
В использовании (6)
-
Зарезервировано DMTF (7 4095)
-
Проверенные параметры метода — переход запущен (4096)
-
Недопустимый переход состояния (4097)
-
Использование параметра timeout не поддерживается (4098)
-
Занят (4099)
-
Зарезервированный метод (4100 32767)
-
Конкретный поставщик (32768 65535)
Комментарии
Доступ к классу Msvm_ConcreteJob может быть ограничен фильтрацией UAC. Дополнительные сведения см. в разделе Контроль учетных записей пользователей и WMI.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 8 [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2012 [только классические приложения] |
| Пространство имен |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|