Функция SetSystemPowerState (winbase.h)

Статья
08/27/2023

[SetSystemPowerState доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Приложения, написанные для Windows Vista и более поздних версий, должны использовать SetSuspendState .]

Приостанавливает работу системы, отключая питание. В зависимости от параметра ForceFlag функция немедленно приостанавливает операцию или запрашивает разрешение у всех приложений и драйверов устройств перед этим.

Синтаксис

BOOL SetSystemPowerState(
  [in] BOOL fSuspend,
  [in] BOOL fForce
);

Параметры

[in] fSuspend

Если этот параметр имеет значение TRUE, система приостанавливается. Если параметр имеет значение FALSE, система перейдет в режим гибернации.

[in] fForce

Данный параметр не оказывает влияния.

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

Если питание было приостановлено и впоследствии восстановлено, возвращаемое значение не равно нулю.

Если система не была приостановлена, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Вызывающий процесс должен иметь привилегию SE_SHUTDOWN_NAME . Чтобы включить привилегию SE_SHUTDOWN_NAME , используйте функцию AdjustTokenPrivileges . Дополнительные сведения см. в разделе Изменение привилегий в токене.

Если какое-либо приложение или драйвер отклоняет разрешение на приостановку операции, функция передает событие PBT_APMQUERYSUSPENDFAILED каждому приложению и драйверу. Если питание приостановлено, эта функция возвращается только после возобновления работы системы и передачи связанных WM_POWERBROADCAST сообщений всем приложениям и драйверам.

Эта функция аналогична функции SetSuspendState .

Чтобы скомпилировать приложение, использующее эту функцию, определите макрос _WIN32_WINNT как 0x0400 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll