IWiaItem::FindItemByName-Methode (wia_xp.h)

Die IWiaItem::FindItemByName-Methode durchsucht die Struktur von Unterelementen eines Elements unter Verwendung des Namens als Suchschlüssel. Jedes IWiaItem-Objekt hat einen Namen als eine seiner Standardeigenschaften.

Syntax

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

Parameter

[in] lFlags

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

[in] bstrFullItemName

Typ: BSTR

Gibt den Namen des Elements an, nach dem gesucht werden soll.

[out] ppIWiaItem

Typ: IWiaItem**

Zeiger auf die IWiaItem-Schnittstelle .

Rückgabewert

Typ: HRESULT

Diese Methode gibt S_OK zurück, wenn das Element gefunden wird, oder S_FALSE, wenn das Element nicht gefunden wird. Wenn die Methode fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.

Hinweise

Diese Methode durchsucht die Struktur der Unterelemente des aktuellen Elements unter Verwendung des Namens als Suchschlüssel. Wenn IWiaItem::FindItemByName das durch bstrFullItemName angegebene Element findet, speichert es die Adresse eines Zeigers auf die IWiaItem-Schnittstelle des Elements im ppIWiaItem-Parameter .

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppIWiaItem-Parameter empfangen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (wia.h einschließen)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll