Méthode IWiaDrvItem ::FindItemByName (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éfinit la valeur 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 retournée

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é au niveau de l’élément racine dans l’arborescence des éléments du pilote.

Configuration requise

Voir aussi

IWiaDrvItem

IWiaDrvItem ::FindChildItemByName

IWiaDrvItem ::GetFullItemName