UiaFind-Funktion (uiautomationcoreapi.h)

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen (Component Object Model) von Microsoft Benutzeroberflächenautomatisierung verwenden.

 

Ruft einen oder mehrere Benutzeroberflächenautomatisierung Knoten ab, die den Suchkriterien entsprechen.

Syntax

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

Parameter

[in] hnode

Typ: HUIANODE

Der Knoten, der als Ausgangspunkt der Suche verwendet werden soll.

[in] pParams

Typ: UiaFindParams*

Die Adresse einer UiaFindParams-Struktur , die die Suchparameter enthält.

[in] pRequest

Typ: UiaCacheRequest*

Die Adresse einer UiaCacheRequest-Struktur , die angibt, welche Informationen zwischengespeichert werden sollen.

[out] ppRequestedData

Typ: SAFEARRAY**

Die Adresse einer Variablen, die einen Zeiger auf eine SAFEARRAY-Instanz empfängt, die die angeforderten Daten enthält. Dieser Parameter wird nicht initialisiert übergeben. Siehe Hinweise.

[out] ppOffsets

Typ: SAFEARRAY**

Die Adresse einer Variablen, die einen Zeiger auf eine SAFEARRAY-Instanz empfängt, die die Indizes auf das angeforderte Datenarray für den Start der Elementunterstruktur enthält. Dieser Parameter wird nicht initialisiert übergeben.

[out] ppTreeStructures

Typ: SAFEARRAY**

Die Adresse einer Variablen, die einen Zeiger auf ein SAFEARRAY empfängt, der die Beschreibung der Strukturstruktur enthält. Dieser Parameter wird nicht initialisiert übergeben. Siehe Hinweise.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert vorhanden ist.

Hinweise

Die Strukturstruktur wird durch eine Zeichenfolge beschrieben, bei der jedes Zeichen entweder "p" oder "") ist. Das erste Zeichen in der Zeichenfolge stellt immer den Stammknoten dar. Die Zeichenfolge ist NULL , wenn von der Funktion keine Elemente zurückgegeben werden.

Ein "p" stellt einen Knoten (Benutzeroberflächenautomatisierung-Element) dar. Wenn ein "p" direkt auf den anderen folgt, ist der zweite Knoten ein untergeordneter Knoten des ersten. Ein "" stellt einen Schritt zur Sicherung der Struktur dar. Beispielsweise stellt "pp)p" einen Knoten gefolgt von zwei untergeordneten Knoten dar, die gleichgeordnet sind. In "pp))p" ist der letzte Knoten ein gleichgeordneter Knoten des ersten Knotens.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll