IWiaItem2 :: CreateChildItem, méthode

Créez un nouvel é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 [ dans]

Type : long

Spécifie le type d’élément WIA 2,0. Consultez indicateurs de type d’élément WIA.

lCreationFlags [ dans]

Type : long

Spécifie comment créer le nouvel élément.

0 (0)

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

Copier _ _ _ Valeurs de propriété Parent (0x40000000)

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

bstrItemName [ dans]

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 [ à]

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 est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Certains périphériques matériels WIA 2,0 permettent aux applications de créer des éléments dans l’arborescence IWiaItem2 qui représente l’appareil. Les applications doivent tester les périphériques pour voir s’ils prennent en charge cette fonctionnalité. Utilisez l' _ interface IEnumWIA dev _ Caps pour énumérer les fonctionnalités actuelles de l’appareil.

Si l’appareil autorise la création de nouveaux éléments dans l’arborescence IWiaItem2 , l’appel de IWiaItem2 :: CreateChildItem crée un nouvel objet IWiaItem2 qui est un enfant du nœud actuel. Il passe un pointeur vers le nouveau nœud à 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 une _ copie _ _ des valeurs de propriété parent et lItemFlags est égal à zéro, la fonction retourne E _ INVALIDARG.

Configuration requise

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