wiasGetPropertyAttributes, fonction (wiamdef.h)

Article
02/07/2025

La fonction wiasGetPropertyAttributes récupère les indicateurs d’accès et les valeurs valides pour un ensemble de propriétés.

Syntaxe

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

Paramètres

[in] pWiasContext

Pointeur vers un contexte d’élément WIA.

cPropSpec

Spécifie le nombre de propriétés.

[in] pPropSpec

Pointeur vers une structure PROPSPEC indiquant les propriétés pour lesquelles obtenir des valeurs valides et des indicateurs d’accès.

pulAccessFlags

Pointeur vers un tableau qui contient les indicateurs d’accès pour les propriétés.

[out] pPropVar

Pointeur vers un tableau de structures PROPVARIANT qui contient les valeurs valides pour les propriétés.

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 remplit chaque élément du tableau pPropVar avec une structure PROPVARIANT qui spécifie les valeurs valides pour la propriété correspondante. Les propriétés avec l’indicateur de droits d’accès WIA_PROP_NONE n’ont aucune valeur valide pour cette propriété. Le type de données pour les valeurs valides de ces propriétés est VT_EMPTY.

Un ou plusieurs attributs de propriété WIA_PROP_Xxx et les indicateurs d’accès peuvent être retournés dans chaque élément du tableau pulAccessFlags.

Si la propriété a une plage de valeurs valides, les valeurs peuvent être déterminées via le paramètre pPropVar à l’achèvement de cette fonction. Le paramètre pPropVar spécifie un tableau de structures PROPVARIANT.

Les valeurs entières et à virgule flottante valides dans une plage sont accessibles à l’aide des constantes d’index suivantes.

Index de valeur valide	Description
WIA_RANGE_MIN	Valeur minimale
WIA_RANGE_NOM	Valeur nominale
WIA_RANGE_MAX	Valeur maximale
WIA_RANGE_STEP	Valeur d’incrémentation

Les valeurs de liste valides sont accessibles à l’aide des constantes d’index suivantes.

Index de valeur valide	Description
WIA_LIST_COUNT	Nombre de valeurs de liste valides, sans compter la valeur nominale
WIA_LIST_NOM	Valeur nominale
WIA_LIST_VALUES	Index à la première valeur valide

Les valeurs d’indicateur de bits valides sont accessibles à l’aide des constantes d’index suivantes.

Index de valeur valide	Description
WIA_FLAG_NOM	Valeur nominale
WIA_FLAG_VALUES	Tous les indicateurs valides sont joints par un opérateur OR

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	wiamdef.h (include Wiamdef.h)
bibliothèque	Wiaservc.lib
DLL	Wiaservc.dll

Partager via