Funzione AccSetRunningUtilityState (oleacc.h)

Imposta i valori di sistema che indicano se lo stato corrente di un'applicazione assistive technology (AT) influisce sulle funzionalità in genere fornite dal sistema.

Sintassi

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

Parametri

[in] hwndApp

Tipo: HWND

Handle della finestra dell'applicazione AT. Questo parametro non deve essere NULL.

[in] dwUtilityStateMask

Tipo: DWORD

Una
maschera che indica i valori di sistema impostati. Può essere una combinazione dei valori seguenti:

ANRUS_ON_SCREEN_KEYBOARD_ACTIVE

ANRUS_TOUCH_MODIFICATION_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK

[in] dwUtilityState

Tipo: DWORD

Le nuove impostazioni per i valori di sistema indicati da dwUtilityStateMask. Questo parametro può essere zero per reimpostare i valori di sistema o una combinazione dei valori seguenti.

Valore Significato
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE
0x0000001
L'applicazione AT fornisce una tastiera sullo schermo.
ANRUS_TOUCH_MODIFICATION_ACTIVE
0x0000002
L'applicazione AT usa l'input tocco reindirizzato.
ANRUS_PRIORITY_AUDIO_ACTIVE
0x0000004
L'applicazione AT si basa sull'audio (ad esempio testo-sintesi vocale) per trasmettere informazioni essenziali all'utente e dovrebbe rimanere udibile su altri suoni di sistema.
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK
0x0000008
L'applicazione AT si basa sull'audio (ad esempio testo-sintesi vocale) per trasmettere informazioni essenziali all'utente, ma non deve cambiare rispetto ad altri suoni di sistema.

Valore restituito

Tipo: STDAPI

Se ha esito positivo, restituisce S_OK.

In caso contrario, restituisce un codice di errore COM standard.

Commenti

Prima di uscire, un'applicazione AT deve reimpostare tutti i valori di sistema impostati in precedenza.

Questa funzione richiede che il processo chiamante disponga di privilegi UIAccess o superiori. Se il chiamante non dispone dei privilegi necessari, la chiamata a AccSetRunningUtilityState ha esito negativo e restituisce E_ACCESSDENIED. Per altre informazioni, vedere Considerazioni sulla sicurezza per Assistive Technologies e /MANIFESTUAC (incorpora le informazioni sull'interfaccia utente nel manifesto).

Esempio

Questo esempio di codice illustra come chiamare la funzione 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
    }
}

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione oleacc.h
Libreria Oleacc.lib
DLL Oleacc.dll

Vedi anche

Considerazioni sulla sicurezza per le tecnologie assistive