setSuspendState 函数 (powrprof.h)

通过关闭电源来暂停系统。根据休眠参数，系统将进入暂停 (睡眠) 状态或休眠 (S4) 。

语法

BOOLEAN SetSuspendState(
  [in] BOOLEAN bHibernate,
  [in] BOOLEAN bForce,
  [in] BOOLEAN bWakeupEventsDisabled
);

[in] bHibernate

如果此参数为 TRUE，则系统进入休眠状态。如果参数为 FALSE，则系统挂起。

[in] bForce

此参数不起作用。

[in] bWakeupEventsDisabled

如果此参数为 TRUE，则系统将禁用所有唤醒事件。如果参数为 FALSE，则任何系统唤醒事件仍保持启用状态。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

调用进程必须具有 SE_SHUTDOWN_NAME 特权。若要启用 SE_SHUTDOWN_NAME 权限，请使用 AdjustTokenPrivileges 函数。有关详细信息，请参阅更改令牌中的特权。

应用程序可以使用 SetSuspendState 将系统从工作状态转换为备用状态 (睡眠) ，或者选择性地将休眠 (S4) 状态。此函数类似于 SetSystemPowerState 函数。

有关使用 PowrProf.h 的详细信息，请参阅电源方案。有关可以唤醒系统的事件的信息，请参阅系统唤醒事件。