Fonction AccSetRunningUtilityState (oleacc.h)

Définit des valeurs système qui indiquent si l’état actuel d’une application de technologie d’assistance (AT) affecte les fonctionnalités généralement fournies par le système.

Syntaxe

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

Paramètres

[in] hwndApp

Type : HWND

Handle de la fenêtre d’application AT. Ce paramètre ne doit pas avoir la valeur NULL.

[in] dwUtilityStateMask

Type : DWORD

A
masque qui indique les valeurs système en cours de définition. Il peut s’agir d’une combinaison des valeurs suivantes :

ANRUS_ON_SCREEN_KEYBOARD_ACTIVE

ANRUS_TOUCH_MODIFICATION_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK

[in] dwUtilityState

Type : DWORD

Nouveaux paramètres pour les valeurs système indiquées par dwUtilityStateMask. Ce paramètre peut être zéro pour réinitialiser les valeurs système, ou une combinaison des valeurs suivantes.

Valeur Signification
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE
0x0000001
 L’application AT fournit un clavier à l’écran.
ANRUS_TOUCH_MODIFICATION_ACTIVE
0x0000002
 L’application AT consomme une entrée tactile redirigée.
ANRUS_PRIORITY_AUDIO_ACTIVE
0x0000004
 L’application AT s’appuie sur l’audio (comme la synthèse vocale) pour transmettre des informations essentielles à l’utilisateur et doit rester audible sur d’autres sons système.
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK
0x0000008
 L’application AT s’appuie sur l’audio (comme la synthèse vocale) pour transmettre des informations essentielles à l’utilisateur, mais ne doit pas changer par rapport à d’autres sons système.

Valeur retournée

Type : STDAPI

En cas de réussite, retourne S_OK.

En cas de non-réussite, retourne un code d’erreur COM standard.

Remarques

Avant sa sortie, une application AT doit réinitialiser toutes les valeurs système qu’elle a définies précédemment.

Cette fonction nécessite que le processus appelant dispose de privilèges UIAccess ou supérieurs. Si l’appelant ne dispose pas des privilèges requis, l’appel à AccSetRunningUtilityState échoue et retourne E_ACCESSDENIED. Pour plus d’informations, consultez Considérations relatives à la sécurité pour les technologies d’assistance et /MANIFESTUAC (Incorpore les informations UAC dans le manifeste).

Exemples

Cet exemple de code montre comment appeler la fonction 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
    }
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête oleacc.h
Bibliothèque Oleacc.lib
DLL Oleacc.dll

Voir aussi

Considérations relatives à la sécurité pour les technologies d’assistance

  • Last updated on