Funzione ShutdownTextServices (textserv.h)

Disconnette un host da un'istanza di servizi di testo.

Sintassi

HRESULT ShutdownTextServices(
  [in] IUnknown *pTextServices
);

Parametri

[in] pTextServices

Tipo: IUnknown*

Istanza dei servizi di testo creata da una chiamata precedente alla funzione CreateTextServices .

Valore restituito

Tipo: HRESULT

Se l'oggetto servizi di testo è stato creato correttamente, il valore restituito è S_OK.

Se la funzione ha esito negativo, viene restituito uno dei codici di errore COM seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_INVALIDARG	Il parametro pTextServices non è valido.

Commenti

Un host chiama questa funzione quando l'host viene liberato. La chiamata a questa funzione è necessaria perché tutte le istanze dei servizi di testo mantengono un puntatore host per cui il metodo AddRef non è stato chiamato. Questa funzione chiama il metodo Release nell'istanza dei servizi di testo e, se non è l'ultimo riferimento all'oggetto servizi di testo, nulla il puntatore host nell'oggetto servizi di testo e prepara il controllo per gestire operazioni non riuscite che richiedono servizi host. Questa funzione consente ad altri riferimenti in sospeso all'oggetto servizi di testo di funzionare o non riuscire correttamente a seconda del servizio richiesto.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	textserv.h
DLL	Msftedit.dll

Vedi anche

CreateTextServices