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_* 常數。
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
無法取得指定的接收介面 riid 。 |
|
不支援指定的接收介面。 |
|
無法取得指定的接收物件。 |
備註
後續使用 以 punk 參數表示的相同介面呼叫會當做更新 dwMask 參數的要求來處理。 伺服器不應該在接收上呼叫 AddRef 方法,以回應這類要求。
伺服器只會維護單一連接點。 嘗試建議第二個接收物件失敗,直到移除原始接收對象為止。 應用程式應該使用 ITextStoreAnchor::UnadviseSink 方法,在不需要通知時取消註冊接收物件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | textstor.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |