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.
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 |