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