IRawElementProviderFragment::GetEmbeddedFragmentRoots method

Retrieves an array of root fragments that are embedded in the Microsoft UI Automation tree rooted at the current element.

Syntax

HRESULT GetEmbeddedFragmentRoots(
  SAFEARRAY **pRetVal
);

Parameters

pRetVal

Type: SAFEARRAY**

Receives an array of pointers to the root fragments, or NULL (see Remarks). This parameter is passed uninitialized.

Return Value

Type: HRESULT

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

Remarks

This method returns an array of fragments only if the current element is hosting another automation framework. Most providers return NULL.

Requirements

   
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)

See Also

Best Practices for Using Safe Arrays

Conceptual

IRawElementProviderFragment

Reference