SetSuspendState

電源を落としてシステムをサスペンドする。Hibernate パラメータに応じて、システムはサスペンド (スリープ) または休止 (S4) 状態に入る。

SetSuspendState bHibernate, bForce, bWakeupEventsDisabled

bHibernate : [int] TRUE の場合、システムは休止状態になる。FALSE の場合、システムはサスペンドされる。
bForce : [int] このパラメータは効果を持たない。
bWakeupEventsDisabled : [int] TRUE の場合、システムはすべてのウェイク イベントを無効化する。FALSE の場合、システム ウェイク イベントは有効のまま維持される。

(プラグイン / モジュール : powrprof.dll)

解説

電源を落としてシステムをサスペンドする。Hibernate パラメータに応じて、システムはサスペンド (スリープ) または休止 (S4)
状態に入る。

[戻り値]
関数が成功すると、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]
呼び出しプロセスは SE_SHUTDOWN_NAME 特権を持つ必要がある。この特権を有効にするには
AdjustTokenPrivileges 関数を使う。詳細は Changing Privileges in a Token
を参照。アプリケーションは SetSuspendState を用いてシステムを稼働状態からスタンバイ (スリープ) またはオプションで休止
(S4) 状態へ遷移させられる。この関数は SetSystemPowerState に類似する。PowrProf.h の使用方法の詳細は
Power Schemes を参照。システムをウェイクできるイベントについては System Wake-up Events を参照。

情報