Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
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
Feedback
Was this page helpful?