ITextStoreAnchor::AdviseSink 方法 (textstor.h)

ITextStoreAnchor::AdviseSink 方法从 ITextStoreAnchorSink 接口安装新的建议接收器或修改现有的建议接收器。

语法

HRESULT AdviseSink(
  [in] REFIID   riid,
  [in] IUnknown *punk,
  [in] DWORD    dwMask
);

参数

[in] riid

指定接收器接口。 唯一支持的值是 IID_ITextStoreAnchorSink。

[in] punk

指向接收器接口的指针以建议。 不能为 NULL

[in] dwMask

指定通知建议接收器的事件。 有关可能的参数值的详细信息,请参阅 TS_AS_* 常量

返回值

此方法可以返回其中一个值。

说明
S_OK
方法成功。
E_FAIL
无法获取指定的接收器接口 riid
E_INVALIDARG
不支持指定的接收器接口。
E_UNEXPECTED
无法获取指定的接收器对象。

注解

具有相同接口的后续调用(由 punk 参数表示)作为更新 dwMask 参数的请求进行处理。 服务器不应在接收器上调用 AddRef 方法以响应此类请求。

服务器仅维护单个连接点。 尝试建议第二个接收器对象失败,直到删除原始接收器对象。 当不需要通知时,应用程序应使用 ITextStoreAnchor::UnadviseSink 方法取消注册接收器对象。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 textstor.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITextStoreAnchor

ITextStoreAnchor::UnadviseSink

TS_AS_* 常量