IWiaDrvItem::FindChildItemByName-Methode (wiamindr_lh.h)
Die IWiaDrvItem::FindChildItemByName-Methode durchsucht die Treiberelementstruktur nach einem bestimmten untergeordneten Element.
Syntax
HRESULT FindChildItemByName(
BSTR __MIDL__IWiaDrvItem0010,
IWiaDrvItem **__MIDL__IWiaDrvItem0011
);
Parameter
__MIDL__IWiaDrvItem0010
bstrChildItemName [in]
Gibt eine Zeichenfolge an, die den Namen mit Pfadinformationen des zu suchenden untergeordneten Elements enthält.
__MIDL__IWiaDrvItem0011
ppIChildItem [out, optional]
Verweist auf einen Speicherspeicherort, der die Adresse des gefundenen untergeordneten IWiaDrvItem-Elements empfängt.
Rückgabewert
Wenn die Methode erfolgreich ist, speichert sie einen Zeiger auf das gefundene untergeordnete Element in ppIChildItem und gibt S_OK zurück. Wenn die Methode das untergeordnete Element nicht findet, gibt sie S_FALSE zurück. Wenn die Methode aus einem anderen Grund fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.
Hinweise
Minidriver verwenden diese Methode in der Regel, um eine Treiberelementstruktur nach einem bestimmten untergeordneten Element zu durchsuchen, wenn der Name des untergeordneten Elements bekannt ist. Der vollständige Name des untergeordneten Elements wird in der Methode IWiaDrvItem::GetFullItemName abgerufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |