AccSetRunningUtilityState 関数 (oleacc.h)

[アーティクル]
03/13/2024

支援技術 (AT) アプリケーションの現在の状態が、通常システムによって提供される機能に影響するかどうかを示すシステム値を設定します。

構文

HRESULT AccSetRunningUtilityState(
  [in] HWND  hwndApp,
  [in] DWORD dwUtilityStateMask,
  [in] DWORD dwUtilityState
);

パラメーター

[in] hwndApp

型: HWND

AT アプリケーションウィンドウのハンドル。このパラメーターは NULL にすることはできません。

[in] dwUtilityStateMask

型: DWORD

A
設定されているシステム値を示す mask。次の値の組み合わせを指定できます。

ANRUS_ON_SCREEN_KEYBOARD_ACTIVE

ANRUS_TOUCH_MODIFICATION_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK

[in] dwUtilityState

型: DWORD

dwUtilityStateMask によって示されるシステム値の新しい設定。このパラメーターは、システム値をリセットする場合は 0 にすることも、次の値を組み合わせて使用することもできます。

値	意味
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE 0x0000001	AT アプリケーションは、スクリーンキーボードを提供しています。
ANRUS_TOUCH_MODIFICATION_ACTIVE 0x0000002	AT アプリケーションは、リダイレクトされたタッチ入力を使用しています。
ANRUS_PRIORITY_AUDIO_ACTIVE 0x0000004	AT アプリケーションは、ユーザーに重要な情報を伝えるためにオーディオ (テキスト読み上げなど) に依存しており、他のシステムサウンドに対して聞こえるようにする必要があります。
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK 0x0000008	AT アプリケーションは、オーディオ (テキスト読み上げなど) に依存して重要な情報をユーザーに伝えますが、他のシステムサウンドに対して相対的に変更しないでください。

戻り値

種類: STDAPI

成功した場合は、S_OK を返します。

成功しなかった場合は、標準の COM エラーコードを返します。

注釈

終了する前に、AT アプリケーションは、以前に設定したシステム値をリセットする必要があります。

この関数では、呼び出し元プロセスに UIAccess 以上の特権が必要です。呼び出し元に必要な特権がない場合、 AccSetRunningUtilityState の呼び出しは失敗し、 E_ACCESSDENIEDを返します。詳細については、「支援テクノロジのセキュリティに関する考慮事項」および「/MANIFESTUAC (マニフェストに UAC 情報を埋め込む)」を参照してください。

例

このコード例では、 AccSetRunningUtilityState 関数を呼び出す方法を示します。

if (SUCCEEDED(hr))
{
    // Tell the system that an AT application has registered with the 
    // touch redirector.
    hr = AccSetRunningUtilityState(hwndTouchWindow, 
            ANRUS_TOUCH_MODIFICATION_ACTIVE, 
            ANRUS_TOUCH_MODIFICATION_ACTIVE);
    if (FAILED(hr))
    {
        MyErrorHandler(hr); // Application-defined error handler
    }
}

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	oleacc.h
Library	Oleacc.lib
[DLL]	Oleacc.dll

こちらもご覧ください

支援技術のセキュリティに関する考慮事項

次の方法で共有