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
値 | 説明 |
---|---|
|
通知は、wParam パラメーターが PBT_POWERSETTINGCHANGE のWM_POWERBROADCAST メッセージを使用して送信されます。 |
|
通知は、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 で導入) |