IInvokeProvider::Invoke Method
Sends a request to activate a control and initiate its single, unambiguous action.
Syntax
HRESULT Invoke(VOID);
Return Value
Returns S_OK if successful, or an error value otherwise.
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 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.
See Also