fonction PSPropertyBag_ReadStr (propsys.h)
Lit la valeur de données de chaîne d’une propriété dans un conteneur de propriétés.
Syntaxe
PSSTDAPI PSPropertyBag_ReadStr(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] LPWSTR value,
[out] int characterCount
);
Paramètres
[in] propBag
Type : IPropertyBag*
Pointeur vers un objet IPropertyBag qui représente le conteneur de propriétés dans lequel la propriété est stockée.
[in] propName
Type : LPCWSTR
Chaîne de nom de propriété terminée par null.
[out] value
Type : LPCWSTR
Lorsque cette fonction retourne, contient un pointeur vers une valeur de propriété de chaîne.
[out] characterCount
Type : int
Cette fonction retourne l’entier qui représente la taille (nombre maximal de caractères) du paramètre value retourné.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
L’API de la fonction de propriété du conteneur de propriétés convertit entre les types de fenêtre et le type VARIANT utilisé pour exprimer des valeurs dans un conteneur de propriétés. Cela facilite l’utilisation du conteneur de propriétés, simplifie les applications et évite les erreurs de codage courantes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | propsys.h |
| Bibliothèque | Propsys.lib |
| DLL | Propsys.dll (version 6.0 ou ultérieure) |