SHQueryUserNotificationState

現在のユーザーに対して通知を送信するのが適切かを判定するため、コンピューターの状態をチェックする。

SHQueryUserNotificationState pquns

pquns : [var] 型: QUERY_USER_NOTIFICATION_STATE* この関数が返るときに、QUERY_USER_NOTIFICATION_STATE 列挙体の値の 1 つへのポインターを格納する。

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

解説

現在のユーザーに対して通知を送信するのが適切かを判定するため、コンピューターの状態をチェックする。

[戻り値]
型: HRESULT この関数が成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコードを返す。

[備考]
アプリケーションは、Shell_NotifyIcon が生成するバルーン通知に類似する通知 UI
を表示する前に、SHQueryUserNotificationState を呼び出して戻り値をテストすべきである。通知は、この API が
QNS_ACCEPTS_NOTIFICATIONS
を返したときにのみ表示すべきである。これにより、ユーザーが中断されてはならないプロセスを実行しているかどうかをアプリケーションに通知する。トップレベルウィンドウは、ユーザーがプレゼンテーション設定をオン/オフしたときや、ユーザーセッションがロック/ロック解除されたときに
WM_SETTINGCHANGE
メッセージを受信する。ユーザーがフルスクリーンアプリケーションを開始または停止したときには通知が送信されないことに注意。この関数が
QUNS_QUIET_TIME を返した場合、通知は重要なものに限り表示すべきである。

情報