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

Метод ITransferDestination::Advise (shobjidl_core.h)

  • Статья

Настраивает консультативное подключение для уведомлений о состоянии операций с файлами.

Синтаксис

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Параметры

[in] psink

Тип: ITransferAdviseSink*

Указатель на интерфейс уведомлений ITransferAdviseSink для обновления вызывающего приложения с помощью методов этого интерфейса.

[out] pdwCookie

Тип: DWORD*

Указатель на возвращенный маркер, который однозначно идентифицирует это соединение. Вызывающее приложение использует этот маркер позже для удаления подключения, передав его в метод ITransferDestination::Unadvise . Если подключение не установлено, это значение равно нулю.

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

Тип: HRESULT

Любые значения HRESUL, отличные от перечисленных, указывают на сбой.

Код возврата Описание
S_OK
 Интерфейс успешно связан.
E_UNEXPECTED
 Обработчик может обрабатывать только один интерфейс приемника.

Комментарии

Вызовите метод ITransferDestination::Совет перед вызовом любых других методов ITransferDestination , чтобы обработчик мог вызывать любые возможные ошибки. Если значение не задано, обработчик должен считать, что обратная связь недоступна, и выполнить операцию "по умолчанию".

Требования

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