共用方式為


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_* 常數