Compartilhar via

Função AccSetRunningUtilityState (oleacc.h)

  • Artigo

Define valores do sistema que indicam se o estado atual de um aplicativo de tecnologia adaptativa (AT) afeta a funcionalidade que normalmente é fornecida pelo sistema.

Sintaxe

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

Parâmetros

[in] hwndApp

Digite: HWND

O identificador da janela do aplicativo AT. Esse parâmetro não deve ser NULL.

[in] dwUtilityStateMask

Tipo: DWORD

A
máscara que indica os valores do sistema que estão sendo definidos. Pode ser uma combinação dos seguintes valores:

ANRUS_ON_SCREEN_KEYBOARD_ACTIVE

ANRUS_TOUCH_MODIFICATION_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE

ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK

[in] dwUtilityState

Tipo: DWORD

As novas configurações para os valores do sistema indicados por dwUtilityStateMask. Esse parâmetro pode ser zero para redefinir os valores do sistema ou uma combinação dos valores a seguir.

Valor Significado
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE
0x0000001
 O aplicativo AT está fornecendo um teclado virtual.
ANRUS_TOUCH_MODIFICATION_ACTIVE
0x0000002
 O aplicativo AT está consumindo entrada por toque redirecionada.
ANRUS_PRIORITY_AUDIO_ACTIVE
0x0000004
 O aplicativo AT está contando com áudio (como conversão de texto em fala) para transmitir informações essenciais ao usuário e deve permanecer audível sobre outros sons do sistema.
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK
0x0000008
 O aplicativo AT está contando com áudio (como conversão de texto em fala) para transmitir informações essenciais ao usuário, mas não deve ser alterado em relação a outros sons do sistema.

Retornar valor

Tipo: STDAPI

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará um código de erro COM padrão.

Comentários

Antes de sair, um aplicativo AT deve redefinir todos os valores do sistema definidos anteriormente.

Essa função exige que o processo de chamada tenha UIAccess ou privilégios mais altos. Se o chamador não tiver os privilégios necessários, a chamada para AccSetRunningUtilityState falhará e retornará E_ACCESSDENIED. Para obter mais informações, consulte Considerações de segurança para tecnologias adaptativas e /MANIFESTUAC (insira informações do UAC no manifesto).

Exemplos

Este exemplo de código mostra como chamar a função 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 Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleacc.h
Biblioteca Oleacc.lib
DLL Oleacc.dll

Confira também

Considerações de segurança para tecnologias adaptativas