Méthode IOleLink ::Update (oleidl.h)

Article
03/04/2024

Mises à jour les données mises en cache du document composé pour un objet lié. Cela implique une liaison à la source du lien, si elle n’est pas déjà liée.

Syntaxe

HRESULT Update(
  [in] IBindCtx *pbc
);

Paramètres

[in] pbc

Pointeur vers l’interface IBindCtx sur le contexte de liaison à utiliser dans la liaison de la source de lien. Ce paramètre peut être NULL. Le contexte de liaison met en cache les objets liés pendant le processus de liaison, contient des paramètres qui s’appliquent à toutes les opérations utilisant le contexte de liaison et fournit les moyens par lesquels l’implémentation de liaison doit récupérer des informations sur son environnement. Pour plus d’informations, consultez IBindCtx.

Valeur retournée

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

Code de retour	Description
CACHE_E_NOCACHE_UPDATE	L’opération de liaison a fonctionné, mais aucun cache n’a été mis à jour.
CACHE_S_SOMECACHES_NOTUPDATED	L’opération de liaison a fonctionné, mais tous les caches n’ont pas été mis à jour.
OLE_E_CANT_BINDTOSOURCE	Impossible de lier à la source du lien.

Remarques

Remarques aux appelants

Votre application conteneur doit appeler Update si l’utilisateur final met à jour les données mises en cache pour un objet lié.

L’utilisateur final peut mettre à jour les données mises en cache pour un objet lié en choisissant le bouton Mettre à jour maintenant dans la boîte de dialogue Liens . Si vous utilisez la fonction OleUIEditLinks pour afficher la boîte de dialogue Liens , vous devez implémenter l’interface IOleUILinkContainer . La boîte de dialogue appelle vos implémentations de IOleUILinkContainer ::UpdateLink lorsque l’utilisateur final choisit le bouton Mettre à jour maintenant . Votre implémentation de cette méthode peut appeler Update.

Votre application conteneur peut également appeler Update pour mettre à jour un objet lié, car cette méthode appelle Update lorsqu’elle est appelée sur un objet lié.

Cette méthode met à jour les liens automatiques et les liens manuels. Pour les liens manuels, l’appel de Update ou Update est le seul moyen de mettre à jour les caches. Pour plus d’informations sur les liens automatiques et manuels, consultez IOleLink ::SetUpdateOptions.

Remarques sur l’implémentation

Si pbc n’a pas la valeur NULL, l’implémentation de Update de l’objet lié appelle IBindCtx ::RegisterObjectBound pour inscrire la source de lien liée. Cela garantit que la source du lien reste en cours d’exécution jusqu’à ce que le contexte de liaison soit libéré.

Les caches actuels sont laissés intacts si la source du lien ne peut pas être liée.

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