Funzione CreateTextServices (textserv.h)

Articolo
03/09/2024

La funzione CreateTextServices crea un'istanza di un oggetto servizi di testo. L'oggetto servizi di testo supporta un'ampia gamma di interfacce, tra cui ITextServices e Text Object Model (TOM).

Sintassi

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

Parametri

[in] punkOuter

Tipo: IUnknown*

Puntatore all'interfaccia IUnknown di controllo nell'oggetto esterno se l'oggetto servizi di testo viene creato come parte di un oggetto aggregato. Questo parametro può essere NULL se l'oggetto non fa parte di un'aggregazione.

[in] pITextHost

Tipo: ITextHost*

Puntatore all'implementazione dell'interfaccia ITextHost . Questo puntatore non deve essere NULL.

[out] ppUnk

Tipo: IUnknown**

Puntatore a una variabile che riceve un puntatore all'oggetto IUnknown privato dell'oggetto servizi di testo. È possibile chiamare QueryInterface in questo puntatore per recuperare i puntatori ITextServices o ITextDocument.

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	È stato passato un argomento non valido.
E_OUTOFMEMORY	Impossibile allocare la memoria per l'oggetto servizi di testo.
E_FAIL	Impossibile inizializzare l'oggetto servizi di testo.

Commenti

Un oggetto servizi di testo può essere creato come parte di un oggetto COM-aggregato standard. In caso affermativo, i chiamanti devono seguire regole OLE32 standard per la gestione di oggetti aggregati e puntatori di interfaccia memorizzati nella cache ottenuti tramite QueryInterface dall'IUnknown privato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	textserv.h
Libreria	Riched20.lib
DLL	Msftedit.dll