Метод SetPowerState класса CIM_AggregatePExtent
Метод SetPowerState задает требуемое состояние питания для логического устройства и время, когда устройство должно быть переведено в это состояние. В подклассе набор возможных кодов возврата следует указывать с помощью квалификатора ValueMap в методе . Строки, в которые преобразуется содержимое ValueMap , также должны быть указаны в подклассе в качестве квалификатора массива Значений . Этот метод наследуется от CIM_LogicalDevice.
Дополнительные сведения об использовании этого метода с C/C++ см. в разделе Вызов метода.
Важно!
Классы 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. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.
Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|