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.
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, optional]
Pointe vers un emplacement de mémoire qui recevra l’adresse du IWiaDrvItem élément enfant.
Valeur de retour
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.
Remarques
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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |