IRawElementProviderSimple::HostRawElementProvider property

Specifies the host provider for this element.

This property is read-only.

Syntax

HRESULT get_HostRawElementProvider(
  [out, retval] IRawElementProviderSimple **pRetVal
);

Property value

Type: IRawElementProviderSimple**

The host provider. This parameter is passed uninitialized.

Remarks

This property is generally the Microsoft UI Automation provider for the window of a custom control. UI Automation uses this provider in combination with the custom provider. For example, the runtime identifier of the element is usually obtained from the host provider.

A host provider must be returned in the following cases: when the element is a fragment root, when the element is a simple element (such as a push button), and when the provider is a repositioning placeholder (for more information, see Provider Repositioning). In other cases, the property should be NULL.

Examples

The following example returns the host provider for the window that hosts the control served by this provider.

HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
    return UiaHostProviderFromHwnd(controlHWnd, pRetVal); 
}
            

Requirements

See also

IRawElementProviderSimple

UiaHostProviderFromHwnd