Метод SetPowerState класса CIM_UnitaryComputerSystem

Статья
06/12/2023

Метод SetPowerState класса CIM_UnitaryComputerSystem задает требуемое состояние питания для логического устройства и время, когда устройство должно быть переведено в это состояние. В подклассе набор возможных кодов возврата должен быть указан с помощью квалификатора 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): Выключение питания.
Гибернация (7): Спящий режим.
Soft Off (8): Мягкое выключение.

Время [в]

Указывает, когда должно быть задано состояние питания, либо в виде обычного значения даты и времени, либо в качестве значения интервала (где интервал начинается при получении вызова метода). Если параметр PowerState равен 5 ("Цикл питания"), параметр Time указывает, когда устройство должно снова включиться. Выключение происходит немедленно.

Возвращаемое значение

Возвращает значение 0 (ноль) в случае успешного выполнения, 1 (один), если указанные запросы PowerState и Time не поддерживаются, и другое значение, если произошла другая ошибка.

Эта документация взята из описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Пакету SDK Майкрософт или предоставления дополнительных сведений.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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

CIM_UnitaryComputerSystem
CIM_UnitaryComputerSystem

Поделиться через