Méthode IWiaItem ::FindItemByName (wia_xp.h)

La méthode IWiaItem ::FindItemByName recherche l’arborescence de sous-éléments d’un élément en utilisant le nom comme clé de recherche. Chaque objet IWiaItem a un nom comme l’une de ses propriétés standard.

Syntaxe

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

Paramètres

[in] lFlags

Type : LONG

Actuellement inutilisé. Doit être défini sur zéro (0).

[in] bstrFullItemName

Type : BSTR

Spécifie le nom de l’élément pour lequel effectuer une recherche.

[out] ppIWiaItem

Type : IWiaItem**

Pointeur vers l’interface IWiaItem .

Valeur retournée

Type : HRESULT

Cette méthode retourne S_OK si elle trouve l’élément, ou S_FALSE si elle ne trouve pas l’élément. Si la méthode échoue, elle retourne un code d’erreur COM standard.

Remarques

Cette méthode recherche l’arborescence des sous-éléments de l’élément actif en utilisant le nom comme clé de recherche. Si IWiaItem ::FindItemByName recherche l’élément spécifié par bstrFullItemName, il stocke l’adresse d’un pointeur vers l’interface IWiaItem de l’élément dans le paramètre ppIWiaItem .

Les applications doivent appeler la méthode IUnknown ::Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre ppIWiaItem .

Configuration requise