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)