Função UiaReturnRawElementProvider (uiautomationcoreapi.h)

Obtém uma interface para o provedor de Automação da Interface do Usuário para uma janela.

Sintaxe

LRESULT UiaReturnRawElementProvider(
  [in] HWND                      hwnd,
  [in] WPARAM                    wParam,
  [in] LPARAM                    lParam,
  [in] IRawElementProviderSimple *el
);

Parâmetros

[in] hwnd

Tipo: HWND

O identificador da janela que contém o elemento atendido pelo provedor.

[in] wParam

Tipo: WPARAM

O argumento wParam da mensagem WM_GETOBJECT .

[in] lParam

Tipo: LPARAM

O argumento lParam da mensagem WM_GETOBJECT .

[in] el

Tipo: IRawElementProviderSimple*

O provedor de Automação da Interface do Usuário.

Retornar valor

Tipo: LRESULT

A chave para o processo do cliente se conectar ao processo do servidor por meio de Automação da Interface do Usuário.

Essa função retorna zero quando é usada para notificar Automação da Interface do Usuário que é seguro remover o mapa de eventos gerados pelo provedor. Para obter mais informações, consulte Comentários.

Comentários

Essa função é chamada por um controle quando recebe a mensagem WM_GETOBJECT, para fornecer Automação da Interface do Usuário com o provedor de Automação da Interface do Usuário para o controle. O controle deve passar os parâmetros wParam e lParam para a função UiaReturnRawElementProvider sem filtrá-los primeiro, pois a filtragem pode causar problemas com clientes de Acessibilidade Ativa da Microsoft. O procedimento de janela do controle deve retornar o resultado da chamada de UiaReturnRawElementProvider.

Quando os clientes de Acessibilidade Ativa da Microsoft estão escutando eventos gerados por um provedor de Automação da Interface do Usuário, Automação da Interface do Usuário mantém um mapa dos provedores que geraram eventos. Quando os clientes de Acessibilidade Ativa da Microsoft solicitam mais informações, Automação da Interface do Usuário usa o mapa para rotear as solicitações para os provedores apropriados. Quando uma janela que retornou provedores anteriormente tiver sido destruída, você deverá notificar Automação da Interface do Usuário chamando a função UiaReturnRawElementProvider da seguinte maneira: UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Essa chamada informa Automação da Interface do Usuário que ela pode remover com segurança todas as entradas de mapa que se referem à janela especificada. Essa chamada pode economizar memória porque libera referências aos provedores que estão sendo mantidos pelo mapa de eventos gerados. A função retorna zero quando chamada com esses parâmetros especiais. A Microsoft recomenda fazer essa chamada do manipulador de mensagens WM_DESTROY da janela que retorna os provedores de Automação da Interface do Usuário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcoreapi.h
Biblioteca	Uiautomationcore.lib
DLL	Uiautomationcore.dll