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


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

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

Синтаксис

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

Параметры

[in] psink

Тип: ITransferAdviseSink*

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

[out] pdwCookie

Тип: DWORD*

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

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

Тип: HRESULT

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

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

Комментарии

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

Требования

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