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。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
为 pCallback 参数或 ppszCookie 参数指定了 NULL 值。 |
注解
在清理过程中,应用程序应通过调用 Unadvise 方法取消注册回调对象,然后通过调用 CoTaskMemFree 函数释放 ppszCookie 参数引用的内存。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | portabledeviceapi.h |