IRawElementProviderHwndOverride：：GetOverrideProviderForHwnd 方法 (uiautomationcore.h)
取得指定專案的 使用者介面自動化 提供者。
語法
HRESULT GetOverrideProviderForHwnd(
[in] HWND hwnd,
[out, retval] IRawElementProviderSimple **pRetVal
);
參數
[in] hwnd
類型： HWND
項目的視窗控制代碼。
[out, retval] pRetVal
類型： IRawElementProviderSimple**
接收指定之視窗之新提供者的指標，如果未覆寫提供者，則為 NULL 。 這個參數會以未初始化的狀態傳遞。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
這個方法是由包含視窗型子專案的片段根實作。 根據預設，除了任何自定義提供者之外，Windows 中裝載的控件也會由預設提供者提供服務。 預設提供者會將父視窗內的所有視窗視為同層級。 如果您想要重新建構 使用者介面自動化 樹狀結構，讓某個視窗型控件視為另一個視窗型控件的子系，您必須在片段根目錄上實作此方法來覆寫預設提供者。 傳回的提供者可以提供其他屬性或覆寫指定元件的屬性。
傳回的提供者必須是片段樹狀結構的一部分。 它可以提供其他屬性或覆寫指定元件的屬性。
如果傳回的提供者實作 IRawElementProviderFragment，提供者應該是片段樹狀結構的一部分，而且可以透過從片段的根目錄巡覽來連線。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | uiautomationcore.h (包含 UIAutomation.h) |