Метод IPortableDeviceService::Advise (portabledeviceapi.h)

Метод Advise регистрирует определяемый приложением объект обратного вызова, который получает события службы.

Синтаксис

HRESULT Advise(
  [in]  const DWORD                  dwFlags,
  [in]  IPortableDeviceEventCallback *pCallback,
  [in]  IPortableDeviceValues        *pParameters,
  [out] LPWSTR                       *ppszCookie
);

Параметры

[in] dwFlags

Не используется.

[in] pCallback

Интерфейс IPortableDeviceEventCallback , указывающий регистрируемый объект обратного вызова.

[in] pParameters

Интерфейс IPortableDeviceValues , указывающий параметры регистрации событий, или ЗНАЧЕНИЕ NULL , если объект обратного вызова предназначен для получения всех событий службы.

[out] ppszCookie

Уникальный идентификатор контекста для объекта обратного вызова. Это значение соответствует используемому методом Unadvise для отмены регистрации объекта обратного вызова.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Для параметра pCallback или параметра ppszCookie было указано значение NULL.

Комментарии

Во время очистки приложение должно отменить регистрацию объекта обратного вызова, вызвав метод Unadvise , а затем освободить память, на которую ссылается параметр ppszCookie , вызвав функцию CoTaskMemFree .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	portabledeviceapi.h

См. также раздел

Интерфейс IPortableDeviceService