Função ShutdownTextServices (textserv.h)

Desconecta um host de uma instância de serviços de texto.

Sintaxe

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

Parâmetros

[in] pTextServices

Tipo: IUnknown*

Uma instância de serviços de texto criada por uma chamada anterior para a função CreateTextServices .

Retornar valor

Tipo: HRESULT

Se o objeto de serviços de texto tiver sido criado com êxito, o valor retornado será S_OK.

Se a função falhar, um dos seguintes códigos de erro COM será retornado. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Comentários

Um host chama essa função quando o host está sendo liberado. Chamar essa função é necessário porque todas as instâncias de serviços de texto mantêm um ponteiro de host para o qual o método AddRef não foi chamado. Essa função chama o método Release na instância de serviços de texto e, se essa não for a última referência ao objeto de serviços de texto, anula o ponteiro do host no objeto de serviços de texto e prepara o controle para lidar com operações com falha que exigem serviços de host. Essa função permite que quaisquer outras referências pendentes ao objeto de serviços de texto funcionem ou falhem normalmente dependendo do serviço necessário.

Requisitos

Confira também

CreateTextServices