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 |
|
| IDL |
|