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