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.

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

Siehe auch

Konzept

ITextDocument

ITextHost

ITextServices

Referenz

Fensterlose Rich-Edit-Steuerelemente