IOleUILinkContainerA ::UpdateLink, méthode (oledlg.h)

Article
03/04/2024

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 de conteneur du lien pour cette valeur.

[in] fErrorMessage

Détermine si l’appelant (implémenteur d’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 le définissent sur 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 pour cette opération est insuffisante.

Remarques

Notes 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 où un grand ensemble d’opérations sont effectuées et où 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 seul message pour chaque échec, en supposant qu’il y a des échecs, fournissez un seul message pour tous les échecs à la fin de l’opération.

Notes aux implémenteurs

Pour les liens OLE, appelez IOleObject ::Update.

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

Voir aussi

IOleObject ::Update

IOleUILinkContainer

Partager via