ITextStoreACP::UnadviseSink メソッド (textstor.h)

ITextStoreACP::UnadviseSink メソッドは、TSF マネージャーからの通知が不要になったことを示すために、アプリケーションによって呼び出されます。 TSF マネージャーはシンク インターフェイスを解放し、通知を停止します。

構文

HRESULT UnadviseSink(
  [in] IUnknown *punk
);

パラメーター

[in] punk

シンク オブジェクトへのポインター。 NULL にすることはできません。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
CONNECT_E_NOCONNECTION	アクティブなシンク オブジェクトはありません。

解説

新しいシンク オブジェクトを登録する ITextStoreAnchor::AdviseSink メソッドの呼び出しはすべて、このメソッドの呼び出しと一致する必要があります。 以前に登録されたシンクの dwMask パラメーターのみを更新する ITextStoreAnchor::AdviseSink メソッドの呼び出しでは、ITextStoreAnchor::UnadviseSink メソッドの呼び出しは必要ありません。

たとえば、シンク オブジェクトを登録するために、アプリケーションは ITextStoreAnchor::AdviseSink メソッドを初めて呼び出します。 シンク オブジェクトを登録した後、アプリケーションは同じシンク オブジェクトを使用して ITextStoreAnchor::AdviseSink メソッドをもう一度呼び出して dwMask パラメーターを変更できます。 シンク オブジェクトの登録を解除するために、アプリケーションは ITextStoreAnchor::UnadviseSink メソッドを 呼び出します。

punk パラメーターには、最初に ITextStoreAnchor::AdviseSink メソッドで渡されたポインターと同じ COM ID が必要です。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	textstor.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional の TSF 1.0

関連項目

ITextStoreACP

ITextStoreACP::AdviseSink