IInvokeProvider::Invoke method

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

Syntax


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 | UWP apps]

Minimum supported server

Windows Server 2003 [desktop apps | UWP apps]

Header

UIAutomationCore.h (include UIAutomation.h)

IDL

UIAutomationCore.idl

DLL

Uiautomationcore.dll

See also

IInvokeProvider
UI Automation Providers Overview

 

 

Show: