fonction wiasGetPropertyAttributes (wiamdef.h)

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 retournée

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é et indicateurs d’accès WIA_PROP_Xxx 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 une fois cette fonction terminée. Le paramètre pPropVar spécifie un tableau de structures PROPVARIANT.

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

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

Les valeurs d’indicateur valides au niveau du bit sont accessibles à l’aide des constantes d’index suivantes.

Configuration requise