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