Méthode IWiaItem2::FindItemByName

Recherche l’arborescence de sous-éléments d’un élément en utilisant le nom comme clé de recherche.

Syntaxe

HRESULT FindItemByName(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrFullItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Paramètres

lFlags [in]

Type : LONG

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

bstrFullItemName [in]

Type : BSTR

Spécifie le nom de l’élément à rechercher.

ppIWiaItem2 [out]

Type : IWiaItem2**

Reçoit l’adresse d’un pointeur vers l’interface IWiaItem2 de l’élément trouvé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Notes

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

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

Spécifications