Partager via


PSPropertyBag_ReadLONG, fonction (propsys.h)

Lit une valeur de données LONG à partir d’une propriété dans un conteneur de propriétés.

Syntaxe

PSSTDAPI PSPropertyBag_ReadLONG(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LONG         *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

Chaîne de nom de propriété terminée par null.

[out] value

Type : LONG*

Lorsque cette fonction est retournée, contient un pointeur vers une valeur de propriété LONG .

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si le conteneur de propriétés ne contient pas encore la propriété spécifiée, l’appel réussit toujours.

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 (include Propsys.idl)
Bibliothèque Propsys.lib
DLL Propsys.dll (version 6.0 ou ultérieure)

Voir aussi

PSPropertyBag_WriteLONG