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

Mises à jour les caches de données ou d’affichage d’un gestionnaire d’objets ou d’un objet de liaison.

Syntaxe

HRESULT Update();

Valeur de retour

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour Description
E_FAIL
L'opération a échoué.
OLE_E_CANT_BINDTOSOURCE
Impossible d’exécuter l’objet pour obtenir des données mises à jour. L’objet n’est pas disponible pour une raison quelconque pour l’appelant.
CACHE_E_NOCACHE_UPDATED
Aucun cache n’a été mis à jour.
CACHE_S_SOMECACHES_NOTUPDATED
Certains caches n’ont pas été mis à jour.

Remarques

La méthode Update permet aux conteneurs de conserver les données mises à jour dans leurs objets liés et incorporés. Un objet link peut devenir obsolète si la source du lien a été mise à jour. Un objet incorporé qui contient des liens vers d’autres objets peut également devenir obsolète. Un objet incorporé qui ne contient pas de liens ne peut pas devenir obsolète, car ses données ne sont pas liées à une autre source.

Notes aux implémenteurs

Lorsqu’un conteneur appelle la méthode IOleObject ::Update d’un objet de lien, l’objet link recherche la source du lien et obtient une nouvelle présentation à partir de celui-ci. Ce processus peut également impliquer l’exécution d’une ou plusieurs applications d’objets, ce qui peut prendre du temps.

Lorsqu’un conteneur appelle la méthode IOleObject ::Update d’un objet incorporé, il demande à l’objet de mettre à jour tous les objets de liaison qu’il peut contenir. En réponse, le gestionnaire d’objets appelle de manière récursive IOleObject ::Update pour chacun de ses propres objets liés, en exécutant chacun d’eux selon les besoins.

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