IWiaDrvItem ::FindItemByName, méthode (wiamindr_lh.h)
La méthode IWiaDrvItem ::FindItemByName localise un élément dans une arborescence d’éléments de pilote par le nom complet de l’élément.
Syntaxe
HRESULT FindItemByName(
LONG __MIDL__IWiaDrvItem0007,
BSTR __MIDL__IWiaDrvItem0008,
IWiaDrvItem **__MIDL__IWiaDrvItem0009
);
Paramètres
__MIDL__IWiaDrvItem0007
bstrFullItemName [in]
Spécifie le nom complet de l’élément à rechercher.
__MIDL__IWiaDrvItem0008
lFlags [in]
Réservé. Défini sur zéro.
__MIDL__IWiaDrvItem0009
ppItem [out, facultatif]
Pointe vers un emplacement de mémoire qui recevra l’adresse de l’élément IWiaDrvItem trouvé.
Valeur de retour
Si la méthode réussit, elle stocke un pointeur vers l’élément trouvé dans ppItem et retourne S_OK. Si la méthode échoue, elle place NULL dans ppItem et retourne S_FALSE. Si cette méthode ne trouve pas l’élément requis, elle retourne S_FALSE. Si une erreur s’est produite pendant la recherche, un code d’erreur COM standard est retourné.
Remarques
Les minidrivers appellent cette méthode pour rechercher un élément dans une arborescence d’éléments de pilote lorsque le nom complet de l’élément est connu. Le nom complet de l’élément est obtenu dans la méthode IWiaDrvItem ::GetFullItemName.
Cette méthode démarre la recherche de l’élément spécifié à l’élément racine dans l’arborescence de l’élément de pilote.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |