ISyncMgrEvent::GetLinkReference 方法 (syncmgr.h)

获取事件的热链接的引用。 热链接是一个显示的属性,用户可以单击该属性来执行操作。 这允许处理程序显示用户可在文件夹中一目了然地查看的可用操作。

语法

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

参数

[out] ppszLinkReference

类型: LPWSTR*

此方法返回时,包含指向作为 Unicode 字符串的链接引用的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

当用户单击热链接时,将执行链接引用。 当用户单击该链接时,同步中心将调用 GetObject,请求 ISyncMgrEventLinkUIOperation 接口的 SYNCMGR_OBJECTID_EventLinkClick 对象。 对象使用可由 Run 方法使用的 ISyncMgrEvent 接口指针进行初始化。 如果处理程序不支持此对象 ID,则同步中心会将链接引用传递给 ShellExecute

事件应使用 CoTaskMemAlloc 分配字符串缓冲区,同步中心使用该 CoTaskMemAlloc 解除分配字符串缓冲区。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 syncmgr.h