PShutdownTextServices

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

型: HRESULT

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

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

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