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 una posizione di memoria che riceverà l'indirizzo dell'elemento figlio IWiaDrvItem trovato.
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.
Commenti
I minidriver usano in genere questo metodo per cercare un elemento figlio specifico in un albero degli elementi driver quando il nome dell'elemento figlio è noto. Il nome completo dell'elemento figlio viene ottenuto nel metodo IWiaDrvItem::GetFullItemName.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (include Wiamindr.h) |