Метод RequestStateChange класса CIM_EnabledLogicalElement
Запрашивает изменение состояния элемента на значение, указанное в параметре RequestedState. При изменении запрошенного состояния значения EnabledState и RequestedState элемента будут одинаковыми. Несколько раз вызов метода RequestStateChange может привести к перезаписи или потере более ранних запросов.
Синтаксис
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
Параметры
-
RequestedState [in]
-
Состояние, запрошенное для элемента . Эти сведения будут помещены в свойство RequestedState экземпляра, если код возврата метода RequestStateChange равен 0 ('Завершено без ошибки') или 4096 (0x1000) ('Job Started'). Подробные объяснения значений RequestedState см. в описании свойств EnabledState и RequestedState.
-
Начало (2)
-
Изменяет состояние на "Выполняется".
-
Приостановка (3)
-
Временно останавливает задание. Цель состоит в том, чтобы впоследствии перезапустить задание с помощью start. Во время приостановки можно перейти в состояние "Служба". (Это зависит от задания.)
-
Завершить (4)
-
Останавливает задание чисто, сохраняет данные, сохраняет состояние и завершает все базовые процессы упорядоченным образом.
-
Kill (5)
-
Немедленно завершает задание без необходимости сохранять данные или сохранять состояние.
-
Служба (6)
-
Переводит задание в состояние службы, зависят от поставщика. Возможно, можно перезапустить задание.
-
Зарезервировано DMTF (7.32767)
-
Зарезервировано поставщиком (32768..65535)
Задание [out]
Может содержать ссылку на CIM_ConcreteJob , созданную для отслеживания перехода состояния, инициированного вызовом метода.
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 |
|