Поделиться через

Метод ISyncMgrEvent::GetLinkReference (syncmgr.h)

  • Статья

Возвращает ссылку на горячую ссылку для события. Горячая ссылка — это отображаемое свойство, которое пользователь может щелкнуть для выполнения действия. Это позволяет обработчику отображать доступное действие, которое пользователь может сразу увидеть в папке.

Синтаксис

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

Параметры

[out] ppszLinkReference

Тип: LPWSTR*

При возврате этого метода содержит указатель на ссылку в виде строки Юникода.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Ссылка на ссылку выполняется, когда пользователь щелкает горячую ссылку. Когда пользователь щелкает ссылку, центр синхронизации вызывает GetObject, запрашивая объект SYNCMGR_OBJECTID_EventLinkClick для интерфейса ISyncMgrEventLinkUIOperation . Объект инициализируется с помощью указателя интерфейса ISyncMgrEvent , который может использоваться методом Run . Если обработчик не поддерживает этот идентификатор объекта, центр синхронизации передает ссылку в ShellExecute.

Ожидается, что событие выделит буфер строки с помощью CoTaskMemAlloc, который центр синхронизации использует для освобождения буфера строки.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header syncmgr.h