iTfSource::AdviseSink 方法 (msctf.h)

安裝建議接收。

語法

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

參數

[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