Méthode IOleUILinkContainerW::UpdateLink (oledlg.h)

Article
08/25/2023

Force les liens sélectionnés à se connecter à leur source et à récupérer les informations actuelles.

Syntaxe

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

Paramètres

[in] dwLink

Identificateur unique défini par le conteneur pour un lien unique. Les conteneurs peuvent utiliser le pointeur vers le site conteneur du lien pour cette valeur.

[in] fErrorMessage

Détermine si l’appelant (implémenteur de IOleUILinkContainer) doit afficher un message d’erreur en cas d’échec de la mise à jour d’un lien. La boîte de dialogue Mettre à jour les liens définit cette valeur sur FALSE. Les boîtes de dialogue Propriétés et liens de l’objet lui attribuent la valeur TRUE.

[in] fReserved

Ce paramètre est réservé et doit être défini sur FALSE.

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
E_ACCESSDENIED	Autorisations d’accès insuffisantes.
E_FAIL	L'opération a échoué.
E_INVALIDARG	L’identificateur spécifié n’est pas valide.
E_OUTOFMEMORY	La mémoire disponible est insuffisante pour cette opération.

Notes

Remarques aux appelants

Appelez cette méthode avec fErrorMessage défini sur TRUE dans les cas où l’utilisateur appuie expressément sur un bouton pour mettre à jour un lien, c’est-à-dire appuie sur le bouton Mettre à jour maintenant des liens. Appelez-le avec FALSE dans les cas où le conteneur ne doit jamais afficher de message d’erreur, c’est-à-dire lorsqu’un grand ensemble d’opérations est en cours d’exécution et que l’erreur doit être propagée ultérieurement à l’utilisateur, comme cela peut se produire avec la mesure de progression des liens de mise à jour . Au lieu de fournir un message pour chaque échec, en supposant qu’il y ait des échecs, fournissez un message unique pour tous les échecs à la fin de l’opération.

Remarques aux implémenteurs

Pour les liens OLE, appelez IOleObject::Update.

Spécifications


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

Voir aussi

IOleObject::Update

IOleUILinkContainer

Partager via