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 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

Vedi anche

Considerazioni sulla sicurezza per le tecnologie assistive