IUIAutomationElement::CurrentItemStatus Property

  • Article

Retrieves a description of the status of an item within an element.

Syntax

HRESULT IUIAutomationElement::get_CurrentItemStatus(BSTR *retVal);

Parameters

  • retVal
    The address of a BSTR that receives the status description.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This property enables a client to ascertain whether an element is conveying status about an item. For example, an item associated with a contact in a messaging application might be "Busy" or "Connected".

See Also

UIA_ItemStatusPropertyId, IUIAutomationElement, IUIAutomationElement::CachedItemStatus