IWiaItem2::FindItemByName-Methode

Durchsucht die Unterelementstruktur 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 des zu suchden Elements an.

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 unteren Elemente 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 Schnittstellenzeigen aufrufen, die sie über den ppIWiaItem2-Parameter erhalten.

Requirements (Anforderungen)

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