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 的詳細資訊，請參閱 Power Schemes。如需可以喚醒系統之事件的相關信息，請參閱系統喚醒事件。