Метод SetPowerState класса CIM_Controller
Метод SetPowerState задает требуемое состояние питания для логического устройства и когда устройство должно быть помещено в это состояние. В подклассе необходимо указать набор возможных кодов возврата с помощью квалификатора ValueMap в методе. Строки, в которые преобразуется содержимое ValueMap , также должны быть указаны в подклассе в качестве квалификатора массива значений . Этот метод наследуется от CIM_LogicalDevice.
Важно!
Классы CIM (Common Information Model) DMTF (Распределенная целевая группа управления) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версий CIM 2.x.
Синтаксис
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
Параметры
-
PowerState [in]
-
Значение ValueMap, указывающее требуемое состояние питания для логического устройства.
-
1
-
Полная сила.
-
2
-
Режим экономии электроэнергии с низким питанием.
-
3
-
Резервная мощность.
-
4
-
Энергопотребление другого.
-
5
-
Цикл питания.
-
6
-
Выключение питания.
Время [in]
Указывает, когда необходимо задать состояние питания либо как обычное значение даты и времени, либо как значение интервала (где интервал начинается при получении вызова метода). Если параметр PowerState равен 5 ("Power Cycle"), параметр Time указывает, когда устройство должно снова включить питание. Выключение питания немедленно.
Возвращаемое значение
Возвращает значение 0 (ноль) в случае успешного выполнения, 1 (один), если указанный запрос PowerState и time не поддерживается, а другое значение, если произошла другая ошибка.
Remarks
Этот метод в настоящее время не реализуется WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике. Дополнительные сведения см. в разделе "Создание поставщиков WMI".
Эта документация основана на описаниях классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения в исправление незначительных ошибок, соответствует стандартам документации microsoft SDK или предоставляет дополнительные сведения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|