Méthode IOleLink ::SetSourceDisplayName (oleidl.h)
Définit le nom complet de la source du lien.
Syntaxe
HRESULT SetSourceDisplayName(
[in] LPCOLESTR pszStatusText
);
Paramètres
[in] pszStatusText
Pointeur vers le nom complet de la nouvelle source de lien. Ce paramètre ne peut pas être NULL.
Valeur retournée
Cette méthode retourne S_OK en cas de réussite.
Les valeurs de MkParseDisplayName peuvent également être retournées ici.
Remarques
Remarques aux appelants
Votre application conteneur peut appeler IOleLink ::SetSourceDisplayName lorsque l’utilisateur final modifie la source d’un lien ou interrompt un lien. Notez que cela nécessite que l’objet lié crée un moniker à partir du nom d’affichage. Si vous préférez analyser le nom d’affichage dans un moniker vous-même, votre conteneur peut appeler IOleLink ::SetSourceMoniker au lieu de IOleLink ::SetSourceDisplayName.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 ::SetLinkSource et IOleUILinkContainer ::CancelLink. Votre implémentation de ces méthodes peut appeler IOleLink ::SetSourceDisplayName.
Si votre application conteneur est immédiatement liée à une source de lien nouvellement spécifiée, vous devez appeler MkParseDisplayName et IOleLink ::SetSourceMoniker à la place, puis appeler IOleLink ::BindToSource à l’aide du contexte de liaison de l’opération d’analyse. En réutilisant le contexte de liaison, vous pouvez éviter le chargement redondant d’objets qui pourraient autrement se produire.
Remarques aux implémenteurs
Le contrat pour IOleLink ::SetSourceDisplayName ne spécifie pas quand l’objet lié analyse le nom d’affichage dans un moniker. L’analyse peut se produire avant le retour de IOleLink ::SetSourceDisplayName , ou l’objet lié peut stocker le nom d’affichage et l’analyser uniquement lorsqu’il doit être lié à la source du lien. Notez que l’analyse du nom d’affichage est potentiellement une opération coûteuse, car elle peut nécessiter une liaison à la source du lien. L’implémentation fournie de IOleLink ::SetSourceDisplayName analyse le nom d’affichage, puis libère le contexte de liaison utilisé dans l’opération d’analyse. Cela peut entraîner l’exécution, puis l’arrêt du serveur source de liaison.Si l’objet lié est lié à la source de lien actuelle, l’implémentation de IOleLink ::SetSourceDisplayName interrompt la connexion.
Pour plus d’informations sur la façon dont l’objet lié stocke et utilise le moniker dans la source du lien, consultez IOleLink ::SetSourceMoniker.
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 |