fonction wiasReadPropStr (wiamdef.h)

Article
02/27/2024

La fonction wiasReadPropStr récupère une valeur de propriété de chaîne à partir d’un élément WIA.

Syntaxe

HRESULT wiasReadPropStr(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BSTR   *pbstr,
  [out, optional] BSTR   *pbstrOld,
                  BOOL   bMustExist
);

Paramètres

[in] pWiasContext

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

propid

Spécifie l’identificateur de propriété.

[out] pbstr

Pointeur vers un emplacement mémoire qui reçoit le premier octet de la valeur de chaîne de la propriété.

[out, optional] pbstrOld

Pointeur vers un emplacement de mémoire qui reçoit le premier octet de la valeur précédente de la propriété. Si ces informations ne sont pas nécessaires, définissez ce paramètre sur NULL.

bMustExist

Indique si la propriété doit exister. Si la valeur est TRUE, la propriété doit exister ; si la valeur est FALSE, la propriété n’a pas besoin d’exister.

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’une des erreurs WIA_ERROR_XXX (décrites dans la documentation Microsoft Windows SDK).

Remarques

Lorsque le minidriver a terminé l’utilisation de la chaîne qu’il a reçue de cette fonction, il doit libérer la mémoire utilisée pour la chaîne.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows Me et Windows XP et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wiamdef.h (inclure Wiamdef.h)
Bibliothèque	Wiaservc.lib
DLL	Wiaservc.dll

Voir aussi

Partager via