Méthode ISyncMgrEvent ::GetLinkReference (syncmgr.h)

Obtient la référence pour le lien actif pour l’événement. Le lien actif est une propriété affichée sur laquelle l’utilisateur peut cliquer pour exécuter une action. Cela permet au gestionnaire d’afficher une action disponible que l’utilisateur peut voir en un coup d’œil dans le dossier.

Syntaxe

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

Paramètres

[out] ppszLinkReference

Type : LPWSTR*

Lorsque cette méthode est retournée, contient un pointeur vers une référence de lien sous forme de chaîne Unicode.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La référence de lien est exécutée lorsque l’utilisateur clique sur le lien actif. Lorsque l’utilisateur clique sur le lien, le Centre de synchronisation appelle GetObject, en demandant l’objet SYNCMGR_OBJECTID_EventLinkClick pour l’interface ISyncMgrEventLinkUIOperation . L’objet est initialisé avec un pointeur d’interface ISyncMgrEvent qui peut être utilisé par la méthode Run . Si le gestionnaire ne prend pas en charge cet ID d’objet, le Centre de synchronisation transmet la référence de lien à ShellExecute.

L’événement est censé allouer la mémoire tampon de chaîne à l’aide de CoTaskMemAlloc, que le Centre de synchronisation utilise pour libérer la mémoire tampon de chaîne.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	syncmgr.h