Compartilhar via


Função UiaHostProviderFromHwnd (uiautomationcoreapi.h)

Obtém o provedor de host de uma janela.

Sintaxe

HRESULT UiaHostProviderFromHwnd(
  [in]  HWND                      hwnd,
  [out] IRawElementProviderSimple **ppProvider
);

Parâmetros

[in] hwnd

Tipo: HWND

A janela que contém o elemento atendido pelo provedor.

[out] ppProvider

Tipo: IRawElementProviderSimple**

O provedor de host para a janela.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O objeto recuperado por essa função é útil apenas para responder a chamadas para o método IRawElementProviderSimple::get_HostRawElementProvider . Você não pode usar o objeto para gerar eventos, fornecer propriedades e assim por diante. Se você precisar gerar eventos ou fornecer propriedades, deverá criar um objeto de provedor que implemente totalmente a interface IRawElementProviderSimple .

Exemplos

O exemplo a seguir retorna o provedor de host para a janela que hospeda o controle atendido por esse provedor.

HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
    return UiaHostProviderFromHwnd(controlHWnd, pRetVal); 
} 

Requisitos

   
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

Confira também

Funções para provedores