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
| Requirement | Value |
|---|---|
| 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
Reference