Share via


IInvokeProvider::Invoke 方法 (uiautomationcore.h)

傳送要求以啟動控制項,並啟始其單一明確的動作。

Syntax

HRESULT Invoke();

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

IInvokeProvider::Invoke 是非同步呼叫,必須立即傳回而不封鎖。

注意 這對叫用時直接或間接啟動強制回應對話方塊的控制項特別重要。 任何引發事件的 Microsoft UI 自動化用戶端都會保持封鎖狀態,直到強制回應對話方塊關閉為止。
 
如果可能的話,IInvokeProvider::Invoke會在控制項完成相關聯的動作之後引發 Invoked 事件。

在下列案例中維護 Invoke 要求之前,應該先引發事件:

  • 無法或不適合等待至動作完成。
  • 動作需要使用者互動。
  • 此動作相當耗時,而且會導致呼叫用戶端封鎖很長的時間。

規格需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)
Dll Uiautomationcore.dll

另請參閱

IInvokeProvider

UI 自動化提供者概觀