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