RegisterPowerSettingNotification 関数 (winuser.h)

特定の電源設定イベントの電源設定通知を受信するようにアプリケーションを登録します。

構文

HPOWERNOTIFY RegisterPowerSettingNotification(
  [in] HANDLE  hRecipient,
  [in] LPCGUID PowerSettingGuid,
  [in] DWORD   Flags
);

パラメーター

[in] hRecipient

電源設定通知の送信先を示すハンドル。 対話型アプリケーションの場合、 Flags パラメーターは 0、 hRecipient パラメーターはウィンドウ ハンドルである必要があります。 サービスの場合、Flags パラメーターは 1 つ、hRecipient パラメーターは RegisterServiceCtrlHandlerEx から返されるSERVICE_STATUS_HANDLEである必要があります。

[in] PowerSettingGuid

通知を送信する電源設定の GUID 。 詳細については、「 Power イベントの登録」を参照してください。

[in] Flags

値	説明
DEVICE_NOTIFY_WINDOW_HANDLE 0	通知は、wParam パラメーターが PBT_POWERSETTINGCHANGE のWM_POWERBROADCAST メッセージを使用して送信されます。
DEVICE_NOTIFY_SERVICE_HANDLE 1	通知は、SERVICE_CONTROL_POWEREVENT の dwControl パラメーターと PBT_POWERSETTINGCHANGE の dwEventType を使用して HandlerEx コールバック関数に送信されます。

戻り値

電源通知の登録を解除するための通知ハンドルを返します。 関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-powermanagement-l1-1-0 (Windows 8 で導入)

関連項目

Power Management Functions

Power イベントの登録

UnregisterPowerSettingNotification