IWiaItem2::FindItemByName-Methode

Artikel
06/13/2023

Durchsucht die Struktur von Unterelementen eines Elements unter Verwendung des Namens als Suchschlüssel.

Syntax

HRESULT FindItemByName(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrFullItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Parameter

lFlags [in]

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

bstrFullItemName [in]

Typ: BSTR

Gibt den Namen für das element an, nach dem gesucht werden soll.

ppIWiaItem2 [out]

Typ: IWiaItem2**

Empfängt die Adresse eines Zeigers auf die IWiaItem2-Schnittstelle des gefundenen Elements.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl

Freigeben über