PowerClearRequest 関数 (winbase.h)

電源要求オブジェクトの指定した型の電源要求の数をデクリメントします。

構文

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

電源要求オブジェクトへのハンドル。

[in] RequestType

デクリメントされる電源要求の種類。このパラメーターには、次の値のいずれかを指定できます。

値	意味
PowerRequestDisplayRequired	長期間ユーザー入力がない場合でも、表示はオンのままです。
PowerRequestSystemRequired	ユーザーが非アクティブな期間が経過しても、スリープ状態になる代わりに、システムは引き続き実行されます。
PowerRequestAwayModeRequired	システムはスリープ状態ではなく退席モードに入ります。退席モードでは、システムは引き続き実行されますが、オーディオとビデオをオフにしてスリープ状態になります。
PowerRequestExecutionRequired	呼び出し元のプロセスは、プロセスの有効期間管理メカニズムによって中断または終了されるのではなく、引き続き実行されます。プロセスの実行が許可されるタイミングと期間は、オペレーティングシステムと電源ポリシーの設定によって異なります。 PowerRequestExecutionRequired 要求がアクティブな場合は、PowerRequestSystemRequired を意味します。 PowerRequestExecutionRequired 要求の種類は、アプリケーションでのみ使用できます。サービスでは、この要求の種類を使用できません。 Windows 7 と Windows Server 2008 R2: この要求の種類は、Windows 8 と Windows Server 2012 以降でサポートされています。

関数が成功すると、0 以外の値が返されます。

関数が失敗すると、0 が返されます。詳細なエラー情報を得るには、GetLastError を呼び出します。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winbase.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll