IAccessibleHostingElementProviders::GetEmbeddedFragmentRoots method (uiautomationcore.h)

Retrieves the Microsoft Active Accessibility providers of all windowless Microsoft ActiveX controls that have a Microsoft UI Automation provider implementation, and are hosted in a Microsoft Active Accessibility object that implements the IAccessibleHostingElementProviders interface.

Syntax

HRESULT GetEmbeddedFragmentRoots(
  [out, retval] SAFEARRAY **pRetVal
);

Parameters

[out, retval] pRetVal

Type: SAFEARRAY**

Receives the IRawElementProviderFragmentRoot interface pointers.

Return value

Type: HRESULT

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

Remarks

The container of windowless ActiveX controls implements this method on the same object that implements the IAccessible interface. When called, this method queries each of the contained windowless ActiveX controls for an IRawElementProviderFragmentRoot pointer, and then adds the pointer to the safe array.

This method should not include any providers that do not implement IRawElementProviderFragmentRoot.

Requirements

See also

IAccessibleHostingElementProviders