wiasReadMultiple, fonction (wiamdef.h)
La fonction wiasReadMultiple récupère plusieurs valeurs de propriété à partir d’un élément WIA.
Syntaxe
HRESULT wiasReadMultiple(
[in] BYTE *pWiasContext,
ULONG ulCount,
[in] const PROPSPEC *ps,
[out] PROPVARIANT *pv,
[out, optional] PROPVARIANT *pvOld
);
Paramètres
[in] pWiasContext
Pointeur vers un contexte d’élément WIA.
ulCount
Spécifie le nombre de propriétés à lire.
[in] ps
Pointeur vers le premier élément d’un tableau de structures PROPSPEC contenant les propriétés à lire.
[out] pv
Pointeur vers le premier élément d’un tableau de structures PROPVARIANT. Lors du retour, ces structures contiennent de nouvelles valeurs pour les propriétés.
[out, optional] pvOld
Pointeur vers le premier élément d’un tableau de structures PROPVARIANT précédemment allouées par le minidriver. Lors du retour, le tableau contient les valeurs précédentes des données de propriété. Si ces informations ne sont pas nécessaires, ce paramètre peut être défini sur NULL.
Valeur de retour
En cas de réussite, la fonction retourne S_OK.
Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA .
Remarques
Cette fonction lit plusieurs propriétés à partir d’un élément WIA. Lorsque l’appel réussit, le minidriver doit appeler PropVariantClear sur chaque élément du tableau spécifié par le paramètre pv. Pour plus d’informations, consultez IPropertyStorage ::ReadMultiple.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamdef.h (include Wiamdef.h) |
| bibliothèque | Wiaservc.lib |
| DLL | Wiaservc.dll |