PSPropertyBag_ReadStrAlloc fonction (propsys.h)

Lit une valeur de données de chaîne à partir d’une propriété dans un conteneur de propriétés et alloue de la mémoire pour la chaîne qui est lue.

Syntaxe

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *value
);

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

Pointeur vers une chaîne de nom de propriété terminée par null.

[out] value

Type : PWSTR*

Lorsque cette fonction retourne, contient un pointeur vers une valeur de données de chaîne à partir d’une propriété dans un conteneur de propriétés et alloue de la mémoire pour la chaîne qui est lue. L’appelant de la fonction PSPropertyBag_ReadStrAlloc doit appeler une fonction CoTaskMemFree sur ce paramètre.

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)