Fonction ShutdownTextServices (textserv.h)

Déconnecte un hôte d’un instance de services de texte.

Syntaxe

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

Paramètres

[in] pTextServices

Type : IUnknown*

Un service de texte instance créé par un appel précédent à la fonction CreateTextServices.

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	Le paramètre pTextServices n’est pas valide.

Remarques

Un hôte appelle cette fonction lorsque l’hôte est libéré. L’appel de cette fonction est nécessaire, car toutes les instances de services de texte conservent un pointeur d’hôte pour lequel la méthode AddRef n’a pas été appelée. Cette fonction appelle la méthode Release sur les services de texte instance et, s’il ne s’agit pas de la dernière référence à l’objet de services de texte, annule le pointeur hôte dans l’objet services de texte et prépare le contrôle pour gérer les opérations ayant échoué nécessitant des services hôtes. Cette fonction permet à toutes les autres références en suspens à l’objet de services de texte de fonctionner ou d’échouer correctement en fonction du service requis.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	textserv.h
DLL	Msftedit.dll

Voir aussi

CreateTextServices