Compartir a través de

Función AccSetRunningUtilityState (oleacc.h)

  • Artículo

Establece los valores del sistema que indican si el estado actual de una aplicación de tecnología de asistencia (AT) afecta a la funcionalidad que suele proporcionar el sistema.

Sintaxis

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

Parámetros

[in] hwndApp

Tipo: HWND

Identificador de la ventana de la aplicación AT. Este parámetro no debe ser NULL.

[in] dwUtilityStateMask

Tipo: DWORD

A
máscara que indica los valores del sistema que se establecen. Puede ser una combinación de los valores siguientes:

ANRUS_ON_SCREEN_KEYBOARD_ACTIVE

ANRUS_TOUCH_MODIFICATION_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK

[in] dwUtilityState

Tipo: DWORD

La nueva configuración de los valores del sistema indicados por dwUtilityStateMask. Este parámetro puede ser cero para restablecer los valores del sistema o una combinación de los valores siguientes.

Valor Significado
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE
0x0000001
 La aplicación AT proporciona un teclado en pantalla.
ANRUS_TOUCH_MODIFICATION_ACTIVE
0x0000002
 La aplicación AT consume entradas táctiles redirigidas.
ANRUS_PRIORITY_AUDIO_ACTIVE
0x0000004
 La aplicación AT se basa en audio (por ejemplo, texto a voz) para transmitir información esencial al usuario y debe permanecer audible sobre otros sonidos del sistema.
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK
0x0000008
 La aplicación AT se basa en audio (por ejemplo, texto a voz) para transmitir información esencial al usuario, pero no debe cambiar en relación con otros sonidos del sistema.

Valor devuelto

Tipo: STDAPI

Si se ejecuta correctamente, devuelve S_OK.

Si no se ejecuta correctamente, devuelve un código de error COM estándar.

Comentarios

Antes de salir, una aplicación AT debe restablecer los valores del sistema establecidos anteriormente.

Esta función requiere que el proceso de llamada tenga UIAccess o privilegios superiores. Si el llamador no tiene los privilegios necesarios, se produce un error en la llamada a AccSetRunningUtilityState y devuelve E_ACCESSDENIED. Para obtener más información, vea Consideraciones de seguridad para las tecnologías de asistencia y /MANIFESTUAC (inserta información de UAC en el manifiesto).

Ejemplos

En este ejemplo de código se muestra cómo llamar a la función 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
    }
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleacc.h
Library Oleacc.lib
Archivo DLL Oleacc.dll

Consulte también

Consideraciones de seguridad para tecnologías de asistencia