CreateTextServices, fonction (textserv.h)

Article
03/04/2024

La fonction CreateTextServices crée une instance d’un objet de services de texte. L’objet de services de texte prend en charge diverses interfaces, notamment ITextServices et tom (Text Object Model).

Syntaxe

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

Paramètres

[in] punkOuter

Type : IUnknown*

Pointeur vers l’interface IUnknown de contrôle sur l’objet externe si l’objet services de texte est créé dans le cadre d’un objet d’agrégation. Ce paramètre peut être NULL si l’objet ne fait pas partie d’un agrégat.

[in] pITextHost

Type : ITextHost*

Pointeur vers votre implémentation de l’interface ITextHost . Ce pointeur ne doit pas avoir la valeur NULL.

[out] ppUnk

Type : IUnknown**

Pointeur vers une variable qui reçoit un pointeur vers l’IUnknown privé de l’objet de services de texte. Vous pouvez appeler QueryInterface sur ce pointeur pour récupérer les pointeurs d’interface ITextServices ou ITextDocument .

Valeur retournée

Type : HRESULT

Si l’objet de services de texte a été créé avec succès, la valeur de retour est S_OK.

Si la fonction échoue, l’un des codes d’erreur COM suivants est retourné. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_INVALIDARG	Un argument non valide a été passé.
E_OUTOFMEMORY	La mémoire de l’objet de services de texte n’a pas pu être allouée.
E_FAIL	Impossible d’initialiser l’objet services de texte.

Remarques

Un objet de services de texte peut être créé dans le cadre d’un objet agrégé COM standard. Si c’est le cas, les appelants doivent suivre les règles OLE32 standard pour traiter les objets agrégés et mettre en cache les pointeurs d’interface obtenus via QueryInterface à partir du IUnknown privé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	textserv.h
Bibliothèque	Riched20.lib
DLL	Msftedit.dll