Metodo IWiaDrvItem::FindItemByName (wiamindr_lh.h)
Il metodo IWiaDrvItem::FindItemByName individua un elemento in un albero di elementi driver in base al nome completo dell'elemento.
Sintassi
HRESULT FindItemByName(
LONG __MIDL__IWiaDrvItem0007,
BSTR __MIDL__IWiaDrvItem0008,
IWiaDrvItem **__MIDL__IWiaDrvItem0009
);
Parametri
__MIDL__IWiaDrvItem0007
bstrFullItemName [in]
Specifica il nome completo dell'elemento da trovare.
__MIDL__IWiaDrvItem0008
lFlags [in]
Riservato. Imposta su zero.
__MIDL__IWiaDrvItem0009
ppItem [out, facoltativo]
Punta a una posizione di memoria che riceverà l'indirizzo dell'elemento IWiaDrvItem trovato.
Valore restituito
Se il metodo ha esito positivo, archivia un puntatore all'elemento trovato in ppItem e restituisce S_OK. Se il metodo ha esito negativo, inserisce NULL in ppItem e restituisce S_FALSE. Se questo metodo non trova l'elemento richiesto, restituisce S_FALSE. Se si è verificato un errore durante la ricerca, verrà restituito un codice di errore COM standard.
Commenti
I minidriver chiamano questo metodo per trovare un elemento in un albero degli elementi driver quando il nome completo dell'elemento è noto. Il nome completo dell'elemento viene ottenuto nel metodo IWiaDrvItem::GetFullItemName.
Questo metodo avvia la ricerca dell'elemento specificato nell'elemento radice nell'albero degli elementi del driver.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (includere Wiamindr.h) |