Função CreateTextServices (textserv.h)

Artigo
03/02/2024

A função CreateTextServices cria uma instância de um objeto de serviços de texto. O objeto de serviços de texto dá suporte a uma variedade de interfaces, incluindo ITextServices e o TOM (Text Object Model).

Sintaxe

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

Parâmetros

[in] punkOuter

Tipo: IUnknown*

Ponteiro para a interface IUnknown de controle no objeto externo se o objeto de serviços de texto estiver sendo criado como parte de um objeto de agregação. Esse parâmetro poderá ser NULL se o objeto não fizer parte de uma agregação.

[in] pITextHost

Tipo: ITextHost*

Ponteiro para a implementação da interface ITextHost . Esse ponteiro não deve ser NULL.

[out] ppUnk

Tipo: IUnknown**

Ponteiro para uma variável que recebe um ponteiro para o IUnknown privado do objeto de serviços de texto. Você pode chamar QueryInterface neste ponteiro para recuperar ponteiros de interface ITextServices ou ITextDocument .

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.

Código de retorno	Descrição
E_INVALIDARG	Um argumento inválido foi passado.
E_OUTOFMEMORY	Não foi possível alocar memória para o objeto de serviços de texto.
E_FAIL	O objeto de serviços de texto não pôde ser inicializado.

Comentários

Um objeto de serviços de texto pode ser criado como parte de um objeto com agregação COM padrão. Se for, os chamadores deverão seguir as regras padrão do OLE32 para lidar com objetos agregados e ponteiros de interface de cache obtidos por meio de QueryInterface do IUnknown privado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textserv.h
Biblioteca	Riched20.lib
DLL	Msftedit.dll