Метод SetPowerState класса CIM_LogicalDevice (поставщики WMI CIMWin32)

Статья
06/12/2023

Метод 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	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_LogicalDevice
CIM_LogicalDevice