IWiaDrvItem::FindItemByName-Methode (wiamindr_lh.h)
Die IWiaDrvItem::FindItemByName-Methode sucht ein Element in einer Treiberelementstruktur anhand des vollständigen Namens des Elements.
Syntax
HRESULT FindItemByName(
LONG __MIDL__IWiaDrvItem0007,
BSTR __MIDL__IWiaDrvItem0008,
IWiaDrvItem **__MIDL__IWiaDrvItem0009
);
Parameter
__MIDL__IWiaDrvItem0007
bstrFullItemName [in]
Gibt den vollständigen Namen des zu suchenden Elements an.
__MIDL__IWiaDrvItem0008
lFlags [in]
Reserviert. Auf NULL festlegen.
__MIDL__IWiaDrvItem0009
ppItem [out, optional]
Verweist auf einen Speicherspeicherort, der die Adresse des gefundenen IWiaDrvItem-Elements empfängt.
Rückgabewert
Wenn die Methode erfolgreich ist, speichert sie einen Zeiger auf das gefundene Element in ppItem und gibt S_OK zurück. Wenn die Methode fehlschlägt, platziert sie NULL in ppItem und gibt S_FALSE zurück. Wenn diese Methode das erforderliche Element nicht findet, gibt sie S_FALSE zurück. Wenn während der Suche ein Fehler aufgetreten ist, wird ein standardmäßiger COM-Fehlercode zurückgegeben.
Hinweise
Minidriver rufen diese Methode auf, um ein Element in einer Treiberelementstruktur zu finden, wenn der vollständige Name des Elements bekannt ist. Der vollständige Name des Elements wird in der Methode IWiaDrvItem::GetFullItemName abgerufen.
Diese Methode startet die Suche nach dem angegebenen Element am Stammelement in der Treiberelementstruktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (wiamindr.h einschließen) |