Freigeben über


CreateTextServices-Funktion (textserv.h)

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

Siehe auch

Konzept

ITextDocument

ITextHost

ITextServices

Referenz

Fensterlose Rich-Edit-Steuerelemente