fonction PSPropertyBag_ReadType (propsys.h)
Lit le type de valeur de données d’une propriété stockée dans un conteneur de propriétés.
Syntaxe
PSSTDAPI PSPropertyBag_ReadType(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] VARIANT *var,
[out] VARTYPE type
);
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] var
Type : VARIANT*
Retourne à l’achèvement de la fonction un pointeur vers un type de données VARIANT qui contient la valeur de la propriété.
[out] type
Type : VARTYPE*
Si type est VT_EMPTY, cette fonction lit le VARIANT de la propriété dans le paramètre propBag IPropertyBag. Si le type n’est pas VT_EMPTY et n’est pas le même que le type VARIANT lu, cette fonction tente de convertir le variant lu en VARTYPE défini par le paramètre de type avant de le renvoyer.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
IPropertyBag et IPersistPropertyBag optimisent la fonctionnalité Enregistrer en tant que texte. IPropertyBag et IPropertyBag2 fournissent un objet avec un conteneur de propriétés dans lequel l’objet peut enregistrer ses propriétés de manière permanente. IPropertyBag2 permet à l’objet d’obtenir des informations de type pour chaque propriété : IPropertyBag2::Read entraîne la lecture d’une ou plusieurs propriétés à partir du conteneur de propriétés, et IPropertyBag2::Write entraîne l’enregistrement d’une ou de plusieurs propriétés dans le conteneur de propriétés.
Spécifications
| 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) |