Méthode IWiaDrvItem ::FindChildItemByName (wiamindr_lh.h)
La méthode IWiaDrvItem ::FindChildItemByName recherche un élément enfant spécifique dans l’arborescence des éléments du pilote.
Syntaxe
HRESULT FindChildItemByName(
BSTR __MIDL__IWiaDrvItem0010,
IWiaDrvItem **__MIDL__IWiaDrvItem0011
);
Paramètres
__MIDL__IWiaDrvItem0010
bstrChildItemName [in]
Spécifie une chaîne contenant le nom avec les informations de chemin d’accès de l’élément enfant à rechercher.
__MIDL__IWiaDrvItem0011
ppIChildItem [out, facultatif]
Pointe vers un emplacement de mémoire qui recevra l’adresse de l’élément enfant IWiaDrvItem trouvé.
Valeur retournée
Si la méthode réussit, elle stocke un pointeur vers l’élément enfant trouvé dans ppIChildItem et retourne S_OK. Si la méthode ne parvient pas à trouver l’élément enfant, elle retourne S_FALSE. Si la méthode échoue pour une autre raison, elle retourne un code d’erreur COM standard.
Remarques
Les minidrivers utilisent généralement cette méthode pour rechercher dans une arborescence d’éléments de pilote un élément enfant spécifique lorsque le nom de l’élément enfant est connu. Le nom complet de l’élément enfant est obtenu dans la méthode IWiaDrvItem ::GetFullItemName.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamindr_lh.h (incluez Wiamindr.h) |