ShutdownTextServices-Funktion (textserv.h)

Trennt einen Host von einem Textdienst-instance.

Syntax

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

Parameter

[in] pTextServices

Typ: IUnknown*

Ein Textdienst instance, der durch einen vorherigen Aufruf der CreateTextServices-Funktion erstellt wurde.

Rückgabewert

Typ: HRESULT

Wenn das Textdienstobjekt erfolgreich erstellt wurde, wird der Rückgabewert S_OK.

Wenn die Funktion fehlschlägt, wird einer der folgenden COM-Fehlercodes zurückgegeben. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Hinweise

Ein Host ruft diese Funktion auf, wenn der Host freigegeben wird. Das Aufrufen dieser Funktion ist erforderlich, da alle Textdienstinstanzen einen Hostzeiger verwalten, für den die AddRef-Methode nicht aufgerufen wurde. Diese Funktion ruft die Release-Methode für die Textdienste instance auf. Wenn dies nicht der letzte Verweis auf das Textdienstobjekt ist, wird der Hostzeiger im Textdienstobjekt null und das Steuerelement für die Behandlung fehlerhafter Vorgänge vorbereitet, die Hostdienste erfordern. Diese Funktion ermöglicht es, dass alle anderen ausstehenden Verweise auf das Textdienstobjekt abhängig vom erforderlichen Dienst ordnungsgemäß funktionieren oder fehlschlagen.

Anforderungen

Weitere Informationen

CreateTextServices