RegisterSuspendResumeNotification 関数 (winuser.h)

システムが中断または再開されたときに通知を受信するように登録します。 PowerRegisterSuspendResumeNotification と似ていますが、ユーザー モードで動作し、ウィンドウ ハンドルを受け取ることができます。

構文

HPOWERNOTIFY RegisterSuspendResumeNotification(
  [in] HANDLE hRecipient,
  [in] DWORD  Flags
);

パラメーター

[in] hRecipient

このパラメーターには、サブスクライブ プロセスを表す電源通知またはウィンドウ ハンドルをサブスクライブするためのパラメーターが含まれています。

Flags がDEVICE_NOTIFY_CALLBACK場合、hRecipient はDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS構造体へのポインターとして解釈されます。 この場合、コールバック関数は DeviceNotifyCallbackRoutine です。 Callback 関数を実行すると、発生したイベントの種類を示す Type パラメーターが設定されます。 使用可能な値には、 PBT_APMSUSPEND、 PBT_APMRESUMESUSPEND、 およびPBT_APMRESUMEAUTOMATIC が含まれます。詳細については、「 Power Management イベント 」を参照してください。 Setting パラメーターは、中断/再開通知では使用されません。

Flags がDEVICE_NOTIFY_WINDOW_HANDLEの場合、hRecipient はイベントを配信するウィンドウへのハンドルです。

[in] Flags

このパラメーターは 、DEVICE_NOTIFY_WINDOW_HANDLE または DEVICE_NOTIFY_CALLBACKできます。

戻り値

登録のハンドル。 このハンドルを使用して、通知の登録を解除します。

関数が失敗した場合は、返される値は NULL です。 拡張エラー情報を取得するには 、GetLastError を呼び出します。

要件

こちらもご覧ください

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification