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 |
|
| MIDL |
|