IWiaDrvItem ::FindChildItemByName, méthode (wiamindr_lh.h)
La méthode IWiaDrvItem ::FindChildItemByName recherche l’arborescence des éléments de pilote pour un élément enfant spécifique.
HRESULT FindChildItemByName(
BSTR __MIDL__IWiaDrvItem0010,
IWiaDrvItem **__MIDL__IWiaDrvItem0011
);
__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, optional]
Pointe vers un emplacement de mémoire qui recevra l’adresse du IWiaDrvItem élément enfant.
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 trouve pas 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.
Les minidrivers utilisent généralement cette méthode pour rechercher une arborescence d’éléments de pilote pour 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.
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |