Méthode IPersistSerializedPropStorage ::GetPropertyStorage (propsys.h)

Article
03/01/2024

Obtient les données de stockage de propriétés sérialisées du magasin de propriétés instance.

Syntaxe

HRESULT GetPropertyStorage(
  [out] SERIALIZEDPROPSTORAGE **ppsps,
  [out] DWORD                 *pcb
);

Paramètres

[out] ppsps

Type : SERIALIZEDPROPSTORAGE**

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers les données de stockage de propriété sérialisées.

[out] pcb

Type : DWORD*

Lorsque cette méthode est retournée, contient le nombre d’octets contenus dans les données de stockage de propriétés sérialisées pointées par ppsps.

Valeur retournée

Type : HRESULT

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

Remarques

Le type SERIALIZEDPROPSTORAGE est défini dans Propsys.h comme un type incomplet. Il doit être traité comme un tableau de valeurs BYTE ; le format des données retournées n’est pas spécifié. Le contenu de la structure SERIALIZEDPROPSTORAGE est adapté à la conservation sur disque ou à un autre stockage et peut être utilisé pour initialiser un autre magasin de propriétés via IPersistSerializedPropStorage ::SetPropertyStorage.

Note Il incombe à l’application qui appelle IPersistSerializedPropStorage ::GetPropertyStorage d’appeler ultérieurement CoTaskMemFree pour libérer la mémoire référencée par ppsps quand elle n’est plus nécessaire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h

Partager via