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

  • [アーティクル]

アプリケーションによって呼び出され、TSF マネージャーからの通知が不要であることを示します。 TSF マネージャーはシンク インターフェイスを解放し、通知を停止します。

構文

HRESULT UnadviseSink(
  [in] IUnknown *punk
);

パラメーター

[in] punk

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

戻り値

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

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

解説

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

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

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

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー textstor.h
[DLL] Msctf.dll

関連項目

AdviseSink

ITextStoreACP2