Méthode IPersistStorage ::IsDirty (objidl.h)

Détermine si un objet a changé depuis son dernier enregistrement dans son stockage actuel.

Syntaxe

HRESULT IsDirty();

Valeur de retour

Cette méthode retourne S_OK pour indiquer que l’objet a changé. Sinon, elle retourne S_FALSE.

Remarques

Utilisez cette méthode pour déterminer si un objet doit être enregistré avant de le fermer. L’indicateur sale d’un objet est effacé de manière conditionnelle dans la méthode IPersistStorage ::Save.

Par exemple, vous pouvez optimiser une opération d’enregistrement de fichier en appelant la méthode IPersistStorage ::IsDirty pour chaque objet, puis en appelant la méthode IPersistStorage ::Save uniquement pour les objets sale.

Remarques aux appelants

Vous devez traiter les codes de retour d’erreur comme une indication que l’objet a changé. À moins que cette méthode retourne explicitement S_FALSE, supposons que l’objet doit être enregistré.

Remarques aux implémenteurs

Un objet sans objet contenu vérifie simplement son indicateur de sale pour retourner le résultat approprié.

Un conteneur contenant un ou plusieurs objets contenus doit conserver un indicateur de sale interne défini lorsque l’un de ses objets contenus a changé depuis son dernier enregistrement.

Configuration requise

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

Voir aussi

IPersistStorage