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

Article
03/04/2024

Interrompt la connexion entre un objet lié et sa source de lien.

Syntaxe

HRESULT UnbindSource();

Valeur de retour

Cette méthode retourne S_OK en cas de réussite.

Remarques

En règle générale, vous n’appelez pas UnbindSource directement. Lorsqu’il est nécessaire de désactiver la connexion à la source du lien, votre conteneur appelle généralement IOleObject ::Close ou IUnknown ::Release ; l’implémentation de ces méthodes par l’objet lié appelle UnbindSource. L’implémentation IAdviseSink ::OnClose de l’objet lié appelle également UnbindSource.

Remarques aux implémenteurs

L’implémentation d’UnbindSource par l’objet lié ne fait rien si la source de lien n’est pas liée actuellement. Si la source de lien est liée, UnbindSource appelle les implémentations IOleObject ::Unadvise et IDataObject ::D Unadvise de la source de lien pour supprimer les connexions de conseil à la source de lien. La méthode UnbindSource appelle également l’implémentation IOleContainer ::LockContainer du document composé pour déverrouiller le document composé contenant. Cela annule le verrou sur le conteneur et les connexions de conseil qui ont été établies dans IOleLink ::BindToSource. UnbindSource libère tous les pointeurs d’interface de l’objet lié vers la source du lien.

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