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 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour