Metodo IWiaDrvItem::FindChildItemByName (wiamindr_lh.h)
Il metodo IWiaDrvItem::FindChildItemByName cerca un elemento figlio specifico nell'albero degli elementi del driver.
Sintassi
HRESULT FindChildItemByName(
BSTR __MIDL__IWiaDrvItem0010,
IWiaDrvItem **__MIDL__IWiaDrvItem0011
);
Parametri
__MIDL__IWiaDrvItem0010
bstrChildItemName [in]
Specifica una stringa contenente il nome con le informazioni sul percorso dell'elemento figlio da trovare.
__MIDL__IWiaDrvItem0011
ppIChildItem [out, facoltativo]
Punta a un percorso di memoria che riceverà l'indirizzo del IWiaDrvItem trovato elemento figlio.
Valore restituito
Se il metodo ha esito positivo, archivia un puntatore all'elemento figlio trovato in ppIChildItem e restituisce S_OK. Se il metodo non riesce a trovare l'elemento figlio, restituisce S_FALSE. Se il metodo ha esito negativo per un altro motivo, restituisce un codice di errore COM standard.
Osservazioni
I minidriver usano in genere questo metodo per cercare un elemento figlio specifico in un albero di elementi driver quando il nome dell'elemento figlio è noto. Il nome completo dell'elemento figlio viene ottenuto nel metodo IWiaDrvItem::GetFullItemName.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiamindr_lh.h (include Wiamindr.h) |