UiaReturnRawElementProvider 函数 (uiautomationcoreapi.h)

获取窗口UI 自动化提供程序的接口。

语法

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

参数

[in] hwnd

类型： HWND

包含提供程序提供的元素的窗口的句柄。

[in] wParam

类型： WPARAM

WM_GETOBJECT消息的 wParam 参数。

[in] lParam

类型： LPARAM

WM_GETOBJECT消息的 lParam 参数。

[in] el

类型： IRawElementProviderSimple*

UI 自动化提供程序。

返回值

类型： LRESULT

客户端进程通过UI 自动化连接到服务器进程的密钥。

当用于通知UI 自动化删除提供程序引发的事件映射是安全的时，此函数返回零。 有关详细信息，请参阅“备注”。

注解

控件在收到WM_GETOBJECT消息时调用此函数，以便向控件提供UI 自动化提供程序UI 自动化。 控件应将 wParam 和 lParam 参数传递给 UiaReturnRawElementProvider 函数，而不先筛选它们，因为筛选可能会导致 Microsoft Active Accessibility 客户端出现问题。 控件的窗口过程应返回调用 UiaReturnRawElementProvider 的结果。

当 Microsoft Active Accessibility 客户端侦听UI 自动化提供程序引发的事件时，UI 自动化维护已引发事件的提供程序的映射。 当 Microsoft Active Accessibility 客户端请求更多信息时，UI 自动化使用映射将请求路由到相应的提供程序。 当先前返回的提供程序的窗口被销毁时，应通过调用 UiaReturnRawElementProvider 函数来通知UI 自动化，如下所示：UiaReturnRawElementProvider(hwnd, 0, 0, NULL)。 此调用告知UI 自动化，它可以安全地删除引用指定窗口的所有映射条目。 此调用可以节省内存，因为它会释放对引发的事件映射所持有的提供程序的引用。 使用这些特殊参数调用时，函数返回零。 Microsoft 建议从返回UI 自动化提供程序的窗口的WM_DESTROY消息处理程序进行此调用。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 | UWP 应用]
目标平台	Windows
标头	uiautomationcoreapi.h
Library	Uiautomationcore.lib
DLL	Uiautomationcore.dll