Méthode IWiaItem2::CreateChildItem

Article
06/13/2023

Créez un élément enfant. Ajoute des objets IWiaItem2 à l’arborescence IWiaItem2 d’un appareil.

Syntaxe

HRESULT CreateChildItem(
  [in]  LONG      lItemFlags,
  [in]  LONG      lCreationFlags,
  [in]  BSTR      bstrItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Paramètres

lItemFlags [in]

Type : LONG

Spécifie le type d’élément WIA 2.0. Consultez Indicateurs de type d’élément WIA.

lCreationFlags [in]

Type : LONG

Spécifie comment créer l’élément.

0 (0)

Définissez les valeurs par défaut pour les propriétés de l’enfant.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Copiez les valeurs de toutes les propriétés en lecture/écriture à partir du parent.

bstrItemName [in]

Type : BSTR

Spécifie le nom de l’élément. Ce nom est ajouté à la fin du nom de l’élément parent pour générer le nom complet de l’élément.

ppIWiaItem2 [out]

Type : IWiaItem2**

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

Valeur retournée

Type : HRESULT

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

Notes

Certains périphériques matériels WIA 2.0 permettent aux applications de créer de nouveaux éléments dans l’arborescence IWiaItem2 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 IWiaItem2 , l’appel de IWiaItem2::CreateChildItem crée un objet IWiaItem2 qui est un enfant du nœud actuel. Il transmet un pointeur vers le nouveau nœud vers l’application via 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 .

Si lCreationFlags est COPY_PARENT_PROPERTY_VALUES et que lItemFlags est égal à zéro, la fonction retourne E_INVALIDARG.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Wia.h
IDL	Wia.idl

Partager via