ISyncMgrEvent::GetLinkReference-Methode (syncmgr.h)

Ruft den Verweis für den Hotlink für das Ereignis ab. Der Hotlink ist eine angezeigte Eigenschaft, auf die der Benutzer klicken kann, um eine Aktion auszuführen. Dadurch kann der Handler eine verfügbare Aktion anzeigen, die dem Benutzer auf einen Blick im Ordner angezeigt wird.

Syntax

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

Parameter

[out] ppszLinkReference

Typ: LPWSTR*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen Linkverweis als Unicode-Zeichenfolge.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Linkverweis wird ausgeführt, wenn der Benutzer auf den Hotlink klickt. Wenn der Benutzer auf den Link klickt, ruft das Synchronisierungscenter GetObject auf und fordert das SYNCMGR_OBJECTID_EventLinkClick-Objekt für die ISyncMgrEventLinkUIOperation-Schnittstelle an. Das Objekt wird mit einem ISyncMgrEvent-Schnittstellenzeiger initialisiert, der von der Run-Methode verwendet werden kann. Wenn der Handler diese Objekt-ID nicht unterstützt, übergibt das Sync Center den Linkverweis an ShellExecute.

Es wird erwartet, dass das Ereignis den Zeichenfolgenpuffer mithilfe von CoTaskMemAlloc ordnet, das Sync Center verwendet, um die Zuordnung des Zeichenfolgenpuffers zu beheben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncmgr.h