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

回调对象的唯一上下文 ID。 此值与 Unadvise 方法用于取消注册回调对象的匹配。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
E_POINTER
pCallback 参数或 ppszCookie 参数指定了 NULL 值。

注解

在清理过程中,应用程序应通过调用 Unadvise 方法取消注册回调对象,然后通过调用 CoTaskMemFree 函数释放 ppszCookie 参数引用的内存。

要求

要求
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 portabledeviceapi.h

另请参阅

IPortableDeviceService 接口