Méthode IOleLink::GetSourceMoniker (oleidl.h)
Récupère le moniker identifiant la source de lien d’un objet lié.
Syntaxe
HRESULT GetSourceMoniker(
[out] IMoniker **ppmk
);
Paramètres
[out] ppmk
Adresse d’une variable pointeur IMoniker qui reçoit le pointeur d’interface vers un moniker absolu qui identifie la source du lien. En cas de réussite, l’implémentation doit appeler AddRef sur ppmk ; il incombe à l’appelant d’appeler Release. Si une erreur se produit, l’implémentation doit définir ppmk sur NULL.
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 |
|---|---|
|
Aucun moniker n’est disponible. |
Notes
Remarques aux appelants
Votre application conteneur peut appeler IOleLink::GetSourceMoniker pour afficher la source actuelle d’un lien dans la boîte de dialogue Liens . Notez que cela nécessite que votre conteneur utilise la méthode IMoniker::GetDisplayName pour obtenir le nom complet du moniker. Si vous préférez obtenir le nom d’affichage directement, votre conteneur peut appeler IOleLink::GetSourceDisplayName au lieu de IOleLink::GetSourceMoniker.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::GetLinkSource pour obtenir la chaîne qu’elle doit afficher. Votre implémentation de cette méthode peut appeler IOleLink::GetSourceMoniker.
Remarques aux implémenteurs
L’objet lié stocke à la fois un moniker absolu et un moniker relatif pour la source de lien. Si le moniker relatif n’est pas NULL et qu’un moniker est disponible pour le document composé, IOleLink::GetSourceMoniker retourne le moniker créé en composant le moniker relatif à la fin du moniker du document composé. Sinon, elle retourne le moniker absolu ou, si une erreur se produit, NULL.Le conteneur spécifie le moniker absolu lorsqu’il appelle l’une des fonctions OleCreateLink pour créer un lien. L’application peut appeler IOleLink::GetSourceMoniker ou IOleLink::GetSourceDisplayName pour modifier le moniker absolu. En outre, l’objet lié met automatiquement à jour les monikers chaque fois qu’il est lié à la source du lien, ou lorsqu’il est lié à la source de lien et qu’il reçoit une notification de renommage via la méthode IAdviseSink::OnRename .
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 | oleidl.h |