ITransferDestination::Advise 方法 (shobjidl_core.h)
为有关文件操作状态的通知设置咨询连接。
语法
HRESULT Advise(
[in] ITransferAdviseSink *psink,
[out] DWORD *pdwCookie
);
参数
[in] psink
类型: ITransferAdviseSink*
指向 ITransferAdviseSink 通知接口的指针,用于使用此接口上的方法更新调用应用程序。
[out] pdwCookie
类型: DWORD*
指向唯一标识此连接的返回令牌的指针。 调用应用程序稍后使用此令牌通过将其传递到 ITransferDestination::Unadvise 方法来删除连接。 如果未成功建立连接,则此值为零。
返回值
类型: HRESULT
除列出的之外,任何 HRESULT 都表示失败。
返回代码 | 说明 |
---|---|
|
接口已成功关联。 |
|
处理程序只能处理一个接收器接口。 |
注解
在调用任何其他 ITransferDestination 方法之前调用 ITransferDestination ::Advise,以便处理程序可以针对可能发生的任何错误进行回调。 如果未设置,处理程序应将其视为没有可用反馈的指示,并执行“默认”操作。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |