Метод SetPowerState класса CIM_LogicalDevice (поставщики WMI CIMWin32)
Метод SetPowerState класса 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 ("Power Cycle"), параметр Time указывает, когда устройство должно снова включиться. Немедленное выключение питания.
Возвращаемое значение
Возвращает значение 0 (ноль) в случае успешного выполнения, 1 (один), если указанные запросы PowerState и Time не поддерживаются, и другое значение, если произошла другая ошибка.
Комментарии
В подклассе набор возможных кодов возврата должен быть указан с помощью квалификатора ValueMap в методе . Строки, в которые преобразуется содержимое ValueMap , также должны быть указаны в подклассе в качестве квалификатора массива Значений . Этот метод наследуется от CIM_LogicalDevice.
В настоящее время этот метод не реализуется WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.
Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|