IPersistStorageImpl, classe

  • Article

Cette classe implémente l’interface IPersistStorage .

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.

Syntaxe

template <class T>
class ATL_NO_VTABLE IPersistStorageImpl : public IPersistStorage

Paramètres

T
Votre classe, dérivée de IPersistStorageImpl.

Membres

Méthodes publiques

Nom Description
IPersistStorageImpl ::GetClassID Récupère le CLSID de l’objet.
IPersistStorageImpl ::HandsOffStorage Indique à l’objet de libérer tous les objets de stockage et d’entrer en mode HandsOff. L’implémentation ATL retourne S_OK.
IPersistStorageImpl ::InitNew Initialise un nouveau stockage.
IPersistStorageImpl ::IsDirty Vérifie si les données de l’objet ont changé depuis son dernier enregistrement.
IPersistStorageImpl ::Load Charge les propriétés de l’objet à partir du stockage spécifié.
IPersistStorageImpl ::Save Enregistre les propriétés de l’objet dans le stockage spécifié.
IPersistStorageImpl ::SaveCompleted Avertit un objet qu’il peut revenir en mode Normal pour écrire dans son objet de stockage. L’implémentation ATL retourne S_OK.

Notes

IPersistStorageImpl implémente l’interface IPersistStorage , qui permet à un client de demander à votre objet de charger et d’enregistrer ses données persistantes à l’aide d’un stockage.

L’implémentation de cette classe nécessite une classe T pour rendre une implémentation de l’interface IPersistStreamInit disponible via QueryInterface. En règle générale, cela signifie que la classe T doit dériver d’IPersistStreamInitImpl, fournir une entrée dans IPersistStreamInit la carte COM et utiliser un mappage de propriétés pour décrire les données persistantes de la classe.

Didacticiel ATL sur les articles connexes, création d’un projet ATL

Hiérarchie d'héritage

IPersistStorage

IPersistStorageImpl

Spécifications

En-tête : atlcom.h

IPersistStorageImpl ::GetClassID

Récupère le CLSID de l’objet.

STDMETHOD(GetClassID)(CLSID* pClassID);

Notes

Consultez IPersist ::GetClassID dans le Kit de développement logiciel (SDK) Windows.

IPersistStorageImpl ::HandsOffStorage

Indique à l’objet de libérer tous les objets de stockage et d’entrer en mode HandsOff.

STDMETHOD(HandsOffStorage)(void);

Valeur de retour

Retourne S_OK.

Notes

Consultez IPersistStorage ::HandsOffStorage dans le Kit de développement logiciel (SDK) Windows.

IPersistStorageImpl ::InitNew

Initialise un nouveau stockage.

STDMETHOD(InitNew)(IStorage*);

Notes

L’implémentation ATL délègue à l’interface IPersistStreamInit .

Consultez IPersistStorage :InitNew dans le Kit de développement logiciel (SDK) Windows.

IPersistStorageImpl ::IsDirty

Vérifie si les données de l’objet ont changé depuis son dernier enregistrement.

STDMETHOD(IsDirty)(void);

Notes

L’implémentation ATL délègue à l’interface IPersistStreamInit .

Consultez IPersistStorage :IsDirty dans le Kit de développement logiciel (SDK) Windows.

IPersistStorageImpl ::Load

Charge les propriétés de l’objet à partir du stockage spécifié.

STDMETHOD(Load)(IStorage* pStorage);

Notes

L’implémentation ATL délègue à l’interface IPersistStreamInit . Load utilise un flux nommé « Contenu » pour récupérer les données de l’objet. La méthode Save crée initialement ce flux.

Consultez IPersistStorage :Load dans le Kit de développement logiciel (SDK) Windows.

IPersistStorageImpl ::Save

Enregistre les propriétés de l’objet dans le stockage spécifié.

STDMETHOD(Save)(IStorage* pStorage, BOOL fSameAsLoad);

Notes

L’implémentation ATL délègue à l’interface IPersistStreamInit . Lorsqu’il Save est appelé pour la première fois, il crée un flux nommé « Contenu » sur le stockage spécifié. Ce flux est ensuite utilisé dans les appels ultérieurs vers Save et dans les appels à Charger.

Consultez IPersistStorage :Save in the Windows SDK.

IPersistStorageImpl ::SaveCompleted

Avertit un objet qu’il peut revenir en mode Normal pour écrire dans son objet de stockage.

STDMETHOD(SaveCompleted)(IStorage*);

Valeur de retour

Retourne S_OK.

Notes

Consultez IPersistStorage :SaveCompleted dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

Stockages et flux
IPersistStreamInitImpl, classe
IPersistPropertyBagImpl, classe
Vue d’ensemble de la classe