UiaGetUpdatedCache function (uiautomationcoreapi.h)

Article
02/22/2024

Note This function is deprecated. Client applications should use the Microsoft UI Automation Component Object Model (COM) interfaces instead.

Updates the cache of property values and control patterns.

Syntax

HRESULT UiaGetUpdatedCache(
  [in]  HUIANODE        hnode,
  [in]  UiaCacheRequest *pRequest,
  [in]  NormalizeState  normalizeState,
  [in]  UiaCondition    *pNormalizeCondition,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Parameters

[in] hnode

Type: HUIANODE

The element that updated information is being requested for.

[in] pRequest

Type: UiaCacheRequest*

The address of a UiaCacheRequest structure that specifies the cached information to update.

[in] normalizeState

Type: NormalizeState

A value from the NormalizeState enumerated type specifying the type of normalization.

[in] pNormalizeCondition

Type: UiaCondition*

The address of a UiaCondition structure that specifies a condition against which the information can be normalized, if normalizeState is NormalizeState_Custom.

[out] ppRequestedData

Type: SAFEARRAY**

The address of a variable that receives a pointer to a SAFEARRAY that contains the requested data. This parameter is passed uninitialized. See Remarks.

[out] ppTreeStructure

Type: BSTR*

A pointer to the description of the tree structure. This parameter is passed uninitialized. See Remarks.

Return value

Type: HRESULT

Returns S_OK if successful or an error value otherwise.

Remarks

The tree structure is described by a string where every character is either "p" or ")". The first character in the string always represents the root node. The string is NULL if no elements are returned by the function.

A "p" represents a node (UI Automation element). When one "p" directly follows another, the second node is a child of the first. A ")" represents a step back up the tree. For example, "pp)p" represents a node followed by two child nodes that are siblings of one another. In "pp))p", the last node is a sibling of the first one.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	uiautomationcoreapi.h
Library	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Share via