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(
  [out, retval] SAFEARRAY **pRetVal
);

Parameters

pRetVal [out, retval]

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

Reference

IRawElementProviderFragment

Conceptual

Best Practices for Using Safe Arrays