ShutdownTextServices 函式 (textserv.h)

中斷主機與文字服務實例的連接。

語法

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

參數

[in] pTextServices

類型： IUnknown*

先前呼叫 CreateTextServices 函式所建立的文字服務實例。

傳回值

類型： HRESULT

如果已成功建立文字服務對象，傳回值會S_OK。

如果函式失敗，則會傳回下列其中一個 COM 錯誤碼。 如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

備註

當主機正在釋放時，主機會呼叫此函式。 呼叫此函式是必要的，因為所有文字服務實例都會維護尚未呼叫 AddRef 方法的主機指標。 此函式會在文字服務實例上呼叫 Release 方法，如果這不是文字服務對象的最後一個參考，則會在文字服務物件中清除主機指標，並準備控件來處理需要主機服務的失敗作業。 此函式允許文字服務物件的任何其他未完成參考，根據所需的服務正常運作或失敗。

規格需求

另請參閱

CreateTextServices