IInvokeProvider::Invoke メソッド (uiautomationcore.h)

要求を送信してコントロールをアクティブ化し、その 1 つの明確なアクションを開始します。

構文

HRESULT Invoke();

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

IInvokeProvider::Invoke は非同期呼び出しであり、ブロックせずにすぐに戻る必要があります。

メモ これは、呼び出されたときにモーダル ダイアログを直接または間接的に起動するコントロールに特に重要です。 イベントを引き起こす Microsoft UI オートメーション クライアントは、モーダル ダイアログが閉じられるまでブロックされたままになります。
 
IInvokeProvider::Invoke は、可能であれば、コントロールが関連付けられたアクションを完了した後に、Invoke イベントを発生させます。

イベントは、次のシナリオで Invoke 要求を処理する前に発生する必要があります。

  • 処理が完了するまで待機することが不可能または非現実的である。
  • 処理にユーザー操作が必要になる。
  • このアクションは時間がかかり、呼び出し元のクライアントが長時間ブロックします。

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー uiautomationcore.h (UIAutomation.h を含む)
[DLL] Uiautomationcore.dll

関連項目

IInvokeProvider

UI オートメーション プロバイダーの概要