Função CreateTextServices (textserv.h)

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.

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

Confira também

Conceitual

ITextDocument

ITextHost

ITextServices

Referência

Controles de edição avançada sem janelas