iTfSource::AdviseSink 方法 (msctf.h)

安装建议接收器。

语法

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

parameters

[in] riid

标识要安装的建议接收器的类型。

ITfThreadMgr 对象获取 ITfSource 对象时,此参数可以是下列值之一。

ITfContext 对象获取 ITfSource 对象时,此参数可以是下列值之一。

含义
IID_ITfActiveLanguageProfileNotifySink
安装 ITfActiveLanguageProfileNotifySink 建议接收器。
IID_ITfDisplayAttributeNotifySink
安装 ITfDisplayAttributeNotifySink 建议接收器。
IID_ITfKeyTraceEventSink
安装 ITfKeyTraceEventSink 建议接收器。
IID_ITfPreservedKeyNotifySink
安装 ITfPreservedKeyNotifySink 建议接收器。
IID_ITfThreadFocusSink
安装 ITfThreadFocusSink 建议接收器。
IID_ITfThreadMgrEventSink
安装 ITfThreadMgrEventSink 建议接收器。

[in] punk

建议接收器 IUnknown 指针。

[out] pdwCookie

接收标识 Cookie 的 DWORD 值的地址。 此值用于在后续调用 ITfSource::UnadviseSink 时卸载建议接收器。 如果发生故障,则接收 (DWORD) -1。

返回值

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

说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
CONNECT_E_CANNOTCONNECT
无法安装建议接收器。
CONNECT_E_ADVISELIMIT
已达到最大建议接收器数。
E_FAIL
发生了未指定的错误。
E_OUTOFMEMORY
发生内存分配失败。

要求

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

另请参阅

ITfActiveLanguageProfileNotifySink

ITfCompartment

ITfCompartmentEventSink

ITfContext

ITfContextKeyEventSink

ITfDisplayAttributeNotifySink

ITfEditTransactionSink

ITfInputProcessorProfiles

ITfKeyTraceEventSink

ITfLangBarItem

ITfLangBarItemSink

ITfLanguageProfileNotifySink

ITfPreservedKeyNotifySink

ITfSource

ITfSource::UnadviseSink

ITfStatusSink

ITfSystemLangBarItemSink

ITfTextEditSink

ITfTextLayoutSink

ITfThreadFocusSink

ITfThreadMgr

ITfThreadMgrEventSink