Metodo ISyncMgrEvent::GetLinkReference (syncmgr.h)

Ottiene il riferimento per il collegamento frequente per l'evento. Il collegamento frequente è una proprietà visualizzata che l'utente può fare clic per eseguire un'azione. Ciò consente al gestore di visualizzare un'azione disponibile che l'utente può visualizzare a colpo d'occhio nella cartella.

Sintassi

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

Parametri

[out] ppszLinkReference

Tipo: LPWSTR*

Quando questo metodo restituisce, contiene un puntatore a un riferimento a un collegamento come stringa Unicode.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il riferimento al collegamento viene eseguito quando l'utente fa clic sul collegamento a caldo. Quando l'utente fa clic sul collegamento, Sync Center chiama GetObject, richiedendo l'oggetto SYNCMGR_OBJECTID_EventLinkClick per l'interfaccia ISyncMgrEventLinkUIOperation . L'oggetto viene inizializzato con un puntatore dell'interfaccia ISyncMgrEvent che può essere usato dal metodo Run . Se il gestore non supporta questo ID oggetto, Sync Center passa il riferimento al collegamento a ShellExecute.

L'evento deve allocare il buffer di stringa usando CoTaskMemAlloc, che Sync Center usa per deallocare il buffer di stringa.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h