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

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

UIAutomationCore.h (include UIAutomation.h)

IDL

UIAutomationCore.idl

See also

Reference
IRawElementProviderFragment
Conceptual
Best Practices for Using Safe Arrays

 

 

Community Additions

ADD
Show:
© 2014 Microsoft