ShutdownTextServices 関数 (textserv.h)

テキスト サービス インスタンスからホストを切断します。

構文

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

パラメーター

[in] pTextServices

種類: IUnknown*

CreateTextServices 関数の以前の呼び出しによって作成されたテキスト サービス インスタンス。

戻り値

種類: HRESULT

テキスト サービス オブジェクトが正常に作成された場合、戻り値はS_OK。

関数が失敗した場合は、次のいずれかの COM エラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

注釈

ホストは、ホストが解放されるときにこの関数を呼び出します。 すべてのテキスト サービス インスタンスが AddRef メソッドが呼び出されていないホスト ポインターを保持するため、この関数を呼び出す必要があります。 この関数は、テキスト サービス インスタンスで Release メソッドを呼び出し、これがテキスト サービス オブジェクトへの最後の参照でない場合は、テキスト サービス オブジェクト内のホスト ポインターを null にし、ホスト サービスを必要とする失敗した操作を処理するようにコントロールを準備します。 この関数を使用すると、テキスト サービス オブジェクトへの他の未処理の参照は、必要なサービスに応じて正常に動作または失敗します。

要件

こちらもご覧ください

CreateTextServices