Partager via


CreateTextServices, fonction (textserv.h)

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

Voir aussi

Conceptuel

ITextDocument

ITextHost

ITextServices

Référence

Contrôles d’édition enrichis sans fenêtre