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 |
|---|---|
|
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 |