IInvokeProvider::Invoke method (uiautomationcore.h)

Sends a request to activate a control and initiate its single, unambiguous action.

Syntax

HRESULT Invoke();

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

IInvokeProvider::Invoke is an asynchronous call and must return immediately without blocking.

Note  This is particularly critical for controls that, directly or indirectly, launch a modal dialog when invoked. Any Microsoft UI Automation client that instigated the event will remain blocked until the modal dialog is closed.
 
IInvokeProvider::Invoke raises the Invoked event after the control has completed its associated action, if possible.

The event should be raised before servicing the Invoke request in the following scenarios:

  • It is not possible or practical to wait until the action is complete.
  • The action requires user interaction.
  • The action is time-consuming and will cause the calling client to block for a significant length of time.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header uiautomationcore.h (include UIAutomation.h)
DLL Uiautomationcore.dll

See also

IInvokeProvider

UI Automation Providers Overview