The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IInvokeProvider::Invoke method

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

Syntax

C++


HRESULT Invoke();

Parameters

This method has no parameters.

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

Minimum supported client	Windows XP [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2003 [desktop apps \| Windows Store apps]
Header	UIAutomationCore.h (include UIAutomation.h)
IDL	UIAutomationCore.idl
DLL	Uiautomationcore.dll