IWiaItem ::CreateChildItem, méthode (wia_xp.h)

La méthode IWiaItem ::CreateChildItem est utilisée par les applications pour ajouter des objets IWiaItem à l’arborescence IWiaItem d’un appareil.

Syntaxe

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

Paramètres

[in] lFlags

Type : LONG

Spécifie le type d’élément WIA. Doit être défini sur l’une des valeurs répertoriées dans indicateurs de type d’élément WIA.

[in] bstrItemName

Type : BSTR

Spécifie le nom de l’élément WIA, par exemple « Top ». Vous pouvez considérer ce paramètre comme équivalent à un nom de fichier.

[in] bstrFullItemName

Type : BSTR

Spécifie le nom complet de l’élément WIA. Vous pouvez considérer ce paramètre comme équivalent à un chemin d’accès complet à un fichier, tel que « 003\Root\Top ».

[out] ppIWiaItem

Type : IWiaItem**

Reçoit l’adresse d’un pointeur vers l’interface IWiaItem qui définit la méthode IWiaItem ::CreateChildItem .

Valeur retournée

Type : HRESULT

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

Remarques

Certains périphériques matériels WIA permettent aux applications de créer de nouveaux éléments dans l’arborescence IWiaItem qui représente l’appareil. Les applications doivent tester les appareils pour voir s’ils prennent en charge cette fonctionnalité. Utilisez l’interface IEnumWIA_DEV_CAPS pour énumérer les fonctionnalités de l’appareil actuel.

Si l’appareil autorise la création de nouveaux éléments dans l’arborescence IWiaItem , l’appel de IWiaItem ::CreateChildItem crée un nouvel objet IWiaItem qui est un enfant du nœud actuel. IWiaItem ::CreateChildItem passe un pointeur vers le nouveau nœud vers l’application via 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