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