Función ShutdownTextServices (textserv.h)

Desconecta un host de una instancia de servicios de texto.

Sintaxis

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

Parámetros

[in] pTextServices

Tipo: IUnknown*

Instancia de servicios de texto creada por una llamada anterior a la función CreateTextServices .

Valor devuelto

Tipo: HRESULT

Si el objeto de servicios de texto se creó correctamente, el valor devuelto se S_OK.

Si se produce un error en la función, se devuelve uno de los siguientes códigos de error COM. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_INVALIDARG	El parámetro pTextServices no es válido.

Comentarios

Un host llama a esta función cuando se libera el host. Llamar a esta función es necesaria porque todas las instancias de servicios de texto mantienen un puntero de host para el que no se ha llamado al método AddRef . Esta función llama al método Release en la instancia de servicios de texto y, si no es la última referencia al objeto de servicios de texto, anula el puntero de host en el objeto de servicios de texto y prepara el control para controlar las operaciones con error que requieren servicios host. Esta función permite que cualquier otra referencia pendiente al objeto de servicios de texto funcione o falle correctamente en función del servicio necesario.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	textserv.h
Archivo DLL	Msftedit.dll

Consulte también

CreateTextServices