ITransferSource::Advise 方法 (shobjidl_core.h)

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

语法

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

参数

[in] psink

类型: ITransferAdviseSink*

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

[out] pdwCookie

类型: DWORD*

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

返回值

类型: HRESULT

所列以外的任何 HRESULT 都表示失败。

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

注解

调用此接口中的任何其他方法之前调用 ITransferSource::Advise 以启用咨询会话。 如果未设置,处理程序应将其视为无反馈的指示,并在不咨询调用应用程序的情况下执行“默认”操作。

要求

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