UiaReturnRawElementProvider 函式 (uiautomationcoreapi.h)

取得視窗 使用者介面自動化 提供者的介面。

語法

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*

使用者介面自動化 提供者。

傳回值

類型： LRESULT

透過 使用者介面自動化 連線到伺服器進程的客戶端進程金鑰。

當此函式用來通知 使用者介面自動化 安全地移除提供者引發事件對應時，此函式會傳回零。 如需詳細資訊，請參閱＜備註＞。

備註

當控件收到WM_GETOBJECT訊息時，會呼叫此函式，以提供控件的 使用者介面自動化 提供者 使用者介面自動化。 控件應該將 wParam 和 lParam 參數傳遞至 UiaReturnRawElementProvider 函 式，而不先進行篩選，因為篩選可能會導致 Microsoft Active Accessibility 用戶端發生問題。 控件的視窗程序應該會傳回呼叫 UiaReturnRawElementProvider 的結果。

當 Microsoft Active Accessibility 用戶端接聽 使用者介面自動化 提供者所引發的事件時，使用者介面自動化 會維護已引發事件的提供者對應。 當 Microsoft Active Accessibility 用戶端要求進一步資訊時，使用者介面自動化 會使用對應將要求路由傳送至適當的提供者。 當先前傳回提供者的視窗已終結時，您應該呼叫 UiaReturnRawElementProvider 函式來通知 使用者介面自動化，如下所示：UiaReturnRawElementProvider(hwnd, 0, 0, NULL)。 此呼叫會告知 使用者介面自動化 它可以安全地移除參考指定視窗的所有對應專案。 此呼叫可以節省記憶體，因為它會釋放引發事件對應所持有之提供者的參考。 使用這些特殊參數呼叫時，函式會傳回零。 Microsoft 建議從傳回 使用者介面自動化 提供者之視窗的WM_DESTROY訊息處理程式進行此呼叫。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	uiautomationcoreapi.h
程式庫	Uiautomationcore.lib
Dll	Uiautomationcore.dll