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 |