Функция UiaReturnRawElementProvider (uiautomationcoreapi.h)

Возвращает интерфейс для поставщика модель автоматизации пользовательского интерфейса для окна.

Синтаксис

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

Параметры

[in] hwnd

Тип: HWND

Дескриптор окна, содержащего элемент, обслуживаемый поставщиком.

[in] wParam

Тип: WPARAM

Аргумент wParamсообщения WM_GETOBJECT .

[in] lParam

Тип: LPARAM

Аргумент lParamсообщения WM_GETOBJECT .

[in] el

Тип: IRawElementProviderSimple*

Поставщик модель автоматизации пользовательского интерфейса.

Возвращаемое значение

Тип: LRESULT

Ключ для клиентского процесса для подключения к процессу сервера через модель автоматизации пользовательского интерфейса.

Эта функция возвращает ноль, если используется для уведомления модель автоматизации пользовательского интерфейса о том, что можно безопасно удалить сопоставление событий, вызванных поставщиком. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Эта функция вызывается элементом управления при получении сообщения WM_GETOBJECT для предоставления модель автоматизации пользовательского интерфейса поставщику модель автоматизации пользовательского интерфейса для элемента управления. Элемент управления должен передавать параметры wParam и lParam в функцию UiaReturnRawElementProvider без предварительной фильтрации, так как фильтрация может вызвать проблемы с клиентами Microsoft Active Accessibility. Процедура окна элемента управления должна возвращать результат вызова UiaReturnRawElementProvider.

Когда клиенты Microsoft Active Accessibility прослушивают события, вызванные поставщиком модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса поддерживает карту поставщиков, которые вызвали события. Когда клиенты Microsoft Active Accessibility запрашивают дополнительные сведения, модель автоматизации пользовательского интерфейса использует карту для маршрутизации запросов соответствующим поставщикам. При уничтожении окна, которое ранее возвращало поставщиков, необходимо уведомить модель автоматизации пользовательского интерфейса, вызвав функцию UiaReturnRawElementProvider следующим образом: UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Этот вызов сообщает модель автоматизации пользовательского интерфейса, что он может безопасно удалить все записи карты, которые ссылаются на указанное окно. Этот вызов может сэкономить память, так как он освобождает ссылки на поставщиков, удерживаемых картой вызываемых событий. Функция возвращает ноль при вызове с этими специальными параметрами. Корпорация Майкрософт рекомендует выполнить этот вызов из обработчика сообщений WM_DESTROY окна, возвращающего поставщиков модель автоматизации пользовательского интерфейса.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	uiautomationcoreapi.h
Библиотека	Uiautomationcore.lib
DLL	Uiautomationcore.dll