SHQueryUserNotificationState 関数 (shellapi.h)

現在のユーザーのコンピューターの状態を調べて、通知の送信が適切かどうかを判断します。

構文

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

パラメーター

[out] pquns

種類: QUERY_USER_NOTIFICATION_STATE*

この関数が戻るとき、 には、 QUERY_USER_NOTIFICATION_STATE 列挙体のいずれかの値へのポインターが含まれます。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

アプリケーションは SHQueryUserNotificationState を 呼び出し、戻り値をテストしてから、Shell_NotifyIconによって生成されたバルーン通知に似た通知 UI を表示する必要があります。 通知は、この API が QNS_ACCEPTS_NOTIFICATIONSを返す場合にのみ表示する必要があります。 これにより、ユーザーが中断してはならないプロセスを実行しているかどうかをアプリケーションに通知します。 トップレベル ウィンドウは、ユーザーがプレゼンテーション設定のオンとオフを切り替えたとき、およびユーザーのセッションがロックまたはロック解除されたときにも、 WM_SETTINGCHANGE メッセージを受け取ります。 ユーザーが全画面表示アプリケーションを起動または停止したときに送信される通知がないことに注意してください。

この関数が QUNS_QUIET_TIMEを返す場合は、重大な場合にのみ通知を表示する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shellapi.h
[DLL]	Shell32.dll
API セット	ext-ms-win-shell-shell32-l1-2-0 (Windows 8.1で導入)