IUIAutomation::PollForPotentialSupportedProperties Method

Retrieves the properties that might be supported on a UI Automation element.

Syntax

HRESULT PollForPotentialSupportedProperties(      
    IUIAutomationElement *pElement,
    SAFEARRAY(int) *propertyIds,
    SAFEARRAY(BSTR) *propertyNames
);

Parameters

  • pElement
    [in] The address of the IUIAutomationElement interface of the element to poll.
  • propertyIds
    [out] The address of a SAFEARRAY that receives a pointer to an array of property identifiers. For a list of property IDs, see Property Identifiers.
  • propertyNames
    [out] The address of a SAFEARRAY that receives a pointer to an array of property names.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method is intended only for use by Microsoft UI Automation tools that need to scan for properties and control patterns. It is not intended to be used by UI Automation clients.

There is no guarantee that the element will support any particular property when asked for it later.

See Also

Custom Properties, Events, and Control Patterns, IUIAutomation::PollForPotentialSupportedPatterns, IUIAutomation, Working with Safe Arrays