wiasReadPropStr, fonction (wiamdef.h)
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 de 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 de retour
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 du Kit de développement logiciel (SDK) Microsoft Windows).
Remarques
Une fois le minidriver terminé à l’aide 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows Me et dans Windows XP et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | wiamdef.h (include Wiamdef.h) |
| bibliothèque | Wiaservc.lib |
| DLL | Wiaservc.dll |