Edit

Share via

IProxyProviderWinEventSink::AddStructureChangedEvent method (uiautomationcore.h)

  • Article

Raises an event to notify clients that the structure of the UI Automation tree has changed.

Syntax

HRESULT AddStructureChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] StructureChangeType       structureChangeType,
  [in] SAFEARRAY                 *runtimeId
);

Parameters

[in] pProvider

Type: IRawElementProviderSimple*

A pointer to the provider of the element that is raising the event.

[in] structureChangeType

Type: StructureChangeType

The type of structure change that occurred.

[in] runtimeId

Type: SAFEARRAY*

A pointer to the runtime identifiers of the elements that are affected. These IDs enable applications to identify elements that have been removed and are no longer represented by IUIAutomationElement interfaces.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista, Windows XP with SP3 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008, Windows Server 2003 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header uiautomationcore.h (include UIAutomation.h)

See also

Best Practices for Using Safe Arrays

Conceptual

IProxyProviderWinEventSink

Reference