Función CreateTextServices (textserv.h)

Artículo
08/26/2023

La función CreateTextServices crea una instancia de un objeto de servicios de texto. El objeto de servicios de texto admite una variedad de interfaces, como ITextServices y el modelo de objetos de texto (TOM).

Sintaxis

HRESULT CreateTextServices(
  [in]  IUnknown  *punkOuter,
  [in]  ITextHost *pITextHost,
  [out] IUnknown  **ppUnk
);

Parámetros

[in] punkOuter

Tipo: IUnknown*

Puntero a la interfaz IUnknown de control en el objeto externo si el objeto de servicios de texto se está creando como parte de un objeto agregado. Este parámetro puede ser NULL si el objeto no forma parte de un agregado.

[in] pITextHost

Tipo: ITextHost*

Puntero a la implementación de la interfaz ITextHost . Este puntero no debe ser NULL.

[out] ppUnk

Tipo: IUnknown**

Puntero a una variable que recibe un puntero al IUnknown privado del objeto de servicios de texto. Puede llamar a QueryInterface en este puntero para recuperar punteros de interfaz ITextServices o ITextDocument .

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	Se pasó un argumento no válido.
E_OUTOFMEMORY	No se pudo asignar memoria para el objeto de servicios de texto.
E_FAIL	No se pudo inicializar el objeto de servicios de texto.

Comentarios

Se puede crear un objeto de servicios de texto como parte de un objeto agregado COM estándar. Si es así, los autores de llamadas deben seguir las reglas OLE32 estándar para tratar con objetos agregados y punteros de interfaz de almacenamiento en caché obtenidos a través de QueryInterface del IUnknown privado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	textserv.h
Library	Riched20.lib
Archivo DLL	Msftedit.dll