Fonction AccSetRunningUtilityState (oleacc.h)

Article
08/25/2023

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

Partager via