IRawElementProviderFragment::GetEmbeddedFragmentRoots method (uiautomationcore.h)

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

Syntax

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

Parameters

[out, retval] 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

See also

Best Practices for Using Safe Arrays

Conceptual

IRawElementProviderFragment

Reference