Share via

IRawElementProviderFragment::GetEmbeddedFragmentRoots Method

  • Article

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

Syntax

HRESULT GetEmbeddedFragmentRoots(      
    SAFEARRAY(IRawElementProviderFragmentRoot*) *pRetVal
);

Parameters

  • pRetVal
    [out, retval] The address of a variable that receives an array of pointers to the IRawElementProviderFragmentRoot interfaces of the root fragments, or NULL. This parameter is passed uninitialized.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

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

See Also

IRawElementProviderFragment, Working with Safe Arrays