IOleObject ::IsUpToDate, méthode (oleidl.h)

Vérifie si un objet est à jour.

Syntaxe

HRESULT IsUpToDate();

Valeur de retour

Cette méthode retourne S_OK si l’objet est à jour ; sinon, S_FALSE. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
OLE_E_UNAVAILABLE	La status de l’objet ne peut pas être déterminée en temps opportun.

Remarques

La méthode IOleObject ::IsUpToDate permet aux conteneurs de case activée de manière récursive si tous les objets sont à jour. Autrement dit, lorsque le conteneur appelle cette méthode sur le premier objet, l’objet l’appelle à son tour pour tous ses propres objets, et à leur tour pour tous les leurs, jusqu’à ce que tous les objets aient été vérifiés.

Remarques aux implémenteurs

En raison de la nature récursive de IOleObject ::IsUpToDate, déterminer si un objet est obsolète, en particulier un objet contenant un ou plusieurs autres objets, peut prendre autant de temps que la simple mise à jour de l’objet en premier lieu. Si vous préférez éviter les requêtes longues de ce type, assurez-vous que IOleObject ::IsUpToDate retourne OLE_E_UNAVAILABLE. Dans les cas où l’objet à interroger est petit et ne contient aucun objet lui-même, ce qui rend possible une requête efficace, cette méthode peut retourner S_OK ou S_FALSE.

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	oleidl.h

Voir aussi

IOleObject

IOleObject ::Update