Метод 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)