Funzione UiaFind (uiautomationcoreapi.h)

Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce Microsoft Automazione interfaccia utente Component Object Model (COM).

 

Recupera uno o più nodi Automazione interfaccia utente che corrispondono ai criteri di ricerca.

Sintassi

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

Parametri

[in] hnode

Tipo: HUIANODE

Nodo da usare come punto di partenza della ricerca.

[in] pParams

Tipo: UiaFindParams*

Indirizzo di una struttura UiaFindParams che contiene i parametri di ricerca.

[in] pRequest

Tipo: UiaCacheRequest*

Indirizzo di una struttura UiaCacheRequest che specifica quali informazioni devono essere memorizzate nella cache.

[out] ppRequestedData

Tipo: SAFEARRAY**

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

[out] ppOffsets

Tipo: SAFEARRAY**

Indirizzo di una variabile che riceve un puntatore a un safearray contenente gli indici alla matrice di dati richiesta per la posizione in cui viene avviato il sottoalbero dell'elemento. Questo parametro viene passato non inizializzato.

[out] ppTreeStructures

Tipo: SAFEARRAY**

Indirizzo di una variabile che riceve un puntatore a un SAFEARRAY contenente la 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 non vengono restituiti elementi dalla funzione.

Un elemento "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 di backup dell'albero. Ad esempio, "pp)p" rappresenta un nodo seguito da due nodi figlio che sono fratelli tra loro. In "pp))p", l'ultimo nodo è un fratello 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