Función UiaHostProviderFromHwnd (uiautomationcoreapi.h)

Obtiene el proveedor de host de una ventana.

Sintaxis

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

Parámetros

[in] hwnd

Tipo: HWND

Ventana que contiene el elemento servido por el proveedor.

[out] ppProvider

Tipo: IRawElementProviderSimple**

Proveedor de host de la ventana.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El objeto recuperado por esta función solo es útil para responder a las llamadas al método IRawElementProviderSimple::get_HostRawElementProvider . No puede usar el objeto para generar eventos, proporcionar propiedades, etc. Si necesita generar eventos o proporcionar propiedades, debe crear un objeto de proveedor que implemente completamente la interfaz IRawElementProviderSimple .

Ejemplos

En el ejemplo siguiente se devuelve el proveedor de host de la ventana que hospeda el control servido por este proveedor.

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

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcoreapi.h
Library Uiautomationcore.lib
Archivo DLL Uiautomationcore.dll

Consulte también

Funciones para proveedores