Función UiaReturnRawElementProvider (uiautomationcoreapi.h)

Obtiene una interfaz para el proveedor de Automatización de la interfaz de usuario de una ventana.

Sintaxis

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

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana que contiene el elemento servido por el proveedor.

[in] wParam

Tipo: WPARAM

Argumento wParam del mensaje WM_GETOBJECT .

[in] lParam

Tipo: LPARAM

Argumento lParam del mensaje WM_GETOBJECT .

[in] el

Tipo: IRawElementProviderSimple*

Proveedor de Automatización de la interfaz de usuario.

Valor devuelto

Tipo: LRESULT

Clave para que el proceso de cliente se conecte al proceso del servidor a través de Automatización de la interfaz de usuario.

Esta función devuelve cero cuando se usa para notificar a Automatización de la interfaz de usuario que es seguro quitar el mapa de eventos generado por el proveedor. Para obtener más información, vea la sección Comentarios.

Comentarios

Un control llama a esta función cuando recibe el mensaje de WM_GETOBJECT para proporcionar Automatización de la interfaz de usuario con el proveedor de Automatización de la interfaz de usuario para el control. El control debe pasar los parámetros wParam y lParam a la función UiaReturnRawElementProvider sin filtrarlos primero, ya que el filtrado puede causar problemas con los clientes de accesibilidad activa de Microsoft. El procedimiento de ventana del control debe devolver el resultado de llamar a UiaReturnRawElementProvider.

Cuando los clientes de accesibilidad activa de Microsoft escuchan eventos generados por un proveedor de Automatización de la interfaz de usuario, Automatización de la interfaz de usuario mantiene un mapa de los proveedores que han generado eventos. Cuando los clientes de accesibilidad activa de Microsoft solicitan más información, Automatización de la interfaz de usuario usa el mapa para enrutar las solicitudes a los proveedores adecuados. Cuando se ha destruido una ventana que devolvió anteriormente los proveedores, debe notificar a Automatización de la interfaz de usuario llamando a la función UiaReturnRawElementProvider de la siguiente manera: UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Esta llamada indica a Automatización de la interfaz de usuario que puede quitar de forma segura todas las entradas de mapa que hacen referencia a la ventana especificada. Esta llamada puede guardar memoria porque libera referencias a los proveedores que mantiene el mapa de eventos generado. La función devuelve cero cuando se llama a con estos parámetros especiales. Microsoft recomienda realizar esta llamada desde el controlador de mensajes WM_DESTROY de la ventana que devuelve los proveedores de Automatización de la interfaz de usuario.

Requisitos

Requisito	Value
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