Funzione UiaGetUpdatedCache (uiautomationcoreapi.h)

  • Articolo
Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce COM (Component Object Model) di Microsoft Automazione interfaccia utente.
 
Aggiornamenti la cache dei valori delle proprietà e dei pattern di controllo.

Sintassi

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

Parametri

[in] hnode

Tipo: HUIANODE

Elemento per cui vengono richieste informazioni aggiornate.

[in] pRequest

Tipo: UiaCacheRequest*

Indirizzo di una struttura UiaCacheRequest che specifica le informazioni memorizzate nella cache da aggiornare.

[in] normalizeState

Tipo: NormalizeState

Valore del tipo enumerato NormalizeState che specifica il tipo di normalizzazione.

[in] pNormalizeCondition

Tipo: UiaCondition*

Indirizzo di una struttura UiaCondition che specifica una condizione in base alla quale è possibile normalizzare le informazioni, se normalizeState è NormalizeState_Custom.

[out] ppRequestedData

Tipo: SAFEARRAY**

Indirizzo di una variabile che riceve un puntatore a un SAFEARRAY che contiene i dati richiesti. Questo parametro viene passato non inizializzato. Vedere la sezione Osservazioni.

[out] ppTreeStructure

Tipo: BSTR*

Puntatore alla descrizione della struttura ad albero. Questo parametro viene passato non inizializzato. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

La struttura ad albero è descritta da una stringa in cui ogni carattere è "p" o ")". Il primo carattere nella stringa rappresenta sempre il nodo radice. La stringa è NULL se nessun elemento viene restituito dalla funzione .

Un "p" rappresenta un nodo (elemento Automazione interfaccia utente). Quando una "p" segue direttamente un'altra, il secondo nodo è un elemento figlio del primo. Un ")" rappresenta un passaggio indietro dell'albero. Ad esempio, "pp)p" rappresenta un nodo seguito da due nodi figlio di pari livello l'uno dall'altro. In "pp))p", l'ultimo nodo è un elemento di pari livello del primo.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationcoreapi.h
Libreria Uiautomationcore.lib
DLL Uiautomationcore.dll