Fonction UiaGetUpdatedCache (uiautomationcoreapi.h)

Syntaxe

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

Paramètres

[in] hnode

Type : HUIANODE

Élément pour lequel les informations mises à jour sont demandées.

[in] pRequest

Type : UiaCacheRequest*

Adresse d’une structure UiaCacheRequest qui spécifie les informations mises en cache à mettre à jour.

[in] normalizeState

Type : NormalizeState

Valeur du type énuméré NormalizeState spécifiant le type de normalisation.

[in] pNormalizeCondition

Type : UiaCondition*

Adresse d’une structure UiaCondition qui spécifie une condition par rapport à laquelle les informations peuvent être normalisées, si normalizeState est NormalizeState_Custom.

[out] ppRequestedData

Type : SAFEARRAY**

Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY qui contient les données demandées. Ce paramètre est passé sans être initialisé. Consultez la section Notes.

[out] ppTreeStructure

Type : BSTR*

Pointeur vers la description de l’arborescence. Ce paramètre est passé sans être initialisé. Consultez la section Notes.

Valeur de retour

Type : HRESULT

Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.

Remarques

L’arborescence est décrite par une chaîne où chaque caractère est « p » ou « ». Le premier caractère de la chaîne représente toujours le nœud racine. La chaîne a la valeur NULL si aucun élément n’est retourné par la fonction.

Un « p » représente un nœud (élément UI Automation). Lorsqu’un « p » suit directement un autre, le deuxième nœud est un enfant du premier. Un « ) représente un pas en arrière dans l’arborescence. Par exemple, « pp)p » représente un nœud suivi de deux nœuds enfants frères les uns des autres. Dans « pp))p », le dernier nœud est un frère du premier.

Configuration requise