ITransferDestination：：Advise 方法 (shobjidl_core.h)

  • 项目

为有关文件操作状态的通知设置咨询连接。

语法

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

参数

[in] psink

类型： ITransferAdviseSink*

指向 ITransferAdviseSink 通知接口的指针，用于使用此接口上的方法更新调用应用程序。

[out] pdwCookie

类型： DWORD*

指向唯一标识此连接的返回令牌的指针。 调用应用程序稍后使用此令牌通过将其传递到 ITransferDestination：：Unadvise 方法来删除连接。 如果未成功建立连接，则此值为零。

返回值

类型： HRESULT

除列出的之外，任何 HRESULT 都表示失败。

返回代码 说明
S_OK
 接口已成功关联。
E_UNEXPECTED
 处理程序只能处理一个接收器接口。

注解

在调用任何其他 ITransferDestination 方法之前调用 ITransferDestination ：：Advise，以便处理程序可以针对可能发生的任何错误进行回调。 如果未设置，处理程序应将其视为没有可用反馈的指示，并执行“默认”操作。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)