CreateTextServices-Funktion (textserv.h)

Artikel
08/26/2023

Die CreateTextServices-Funktion erstellt eine instance eines Textdienstobjekts. Das Textdienstobjekt unterstützt eine Vielzahl von Schnittstellen, einschließlich ITextServices und das Text Object Model (TOM).

Syntax

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

Parameter

[in] punkOuter

Typ: IUnknown*

Zeiger auf die steuernde IUnknown-Schnittstelle im äußeren Objekt, wenn das Textdienstobjekt als Teil eines Aggregatobjekts erstellt wird. Dieser Parameter kann NULL sein, wenn das Objekt nicht Teil eines Aggregats ist.

[in] pITextHost

Typ: ITextHost*

Zeiger auf Ihre Implementierung der ITextHost-Schnittstelle . Dieser Zeiger darf nicht NULL sein.

[out] ppUnk

Typ: IUnknown**

Zeiger auf eine Variable, die einen Zeiger auf das private IUnknown des Textdienstobjekts empfängt. Sie können QueryInterface für diesen Zeiger aufrufen, um ITextServices - oder ITextDocument-Schnittstellenzeiger abzurufen.

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.

Rückgabecode	Beschreibung
E_INVALIDARG	Ein ungültiges Argument wurde übergeben.
E_OUTOFMEMORY	Arbeitsspeicher für das Textdienstobjekt konnte nicht zugeordnet werden.
E_FAIL	Das Textdienstobjekt konnte nicht initialisiert werden.

Hinweise

Ein Textdienstobjekt kann als Teil eines COM-aggregierten Standardobjekts erstellt werden. Wenn dies der Grund ist, sollten Aufrufer die OLE32-Standardregeln für den Umgang mit aggregierten Objekten und das Zwischenspeichern von Schnittstellenzeigern befolgen, die über QueryInterface aus dem privaten IUnknown abgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textserv.h
Bibliothek	Riched20.lib
DLL	Msftedit.dll