ITfDocumentMgr::CreateContext-Methode (msctf.h)

Erstellt ein Kontextobjekt.

Syntax

HRESULT CreateContext(
  [in]  TfClientId   tidOwner,
  [in]  DWORD        dwFlags,
  [in]  IUnknown     *punk,
  [out] ITfContext   **ppic,
  [out] TfEditCookie *pecTextStore
);

Parameter

[in] tidOwner

The client identifier. (Der Clientbezeichner.) Für eine Anwendung wird dieser Wert durch einen vorherigen Aufruf von ITfThreadMgr::Activate bereitgestellt. Für einen Textdienst wird dieser Wert in der ITfTextInputProcessor::Activate-Methode bereitgestellt.

[in] dwFlags

Reserviert, muss Null sein.

[in] punk

Zeiger auf ein Objekt, das die Schnittstellen ITextStoreACP oder ITfContextOwnerCompositionSink unterstützt. Dieser Wert kann NULL sein.

[out] ppic

Adresse eines ITfContext-Zeigers , der den Kontext empfängt.

[out] pecTextStore

Zeiger auf einen TfEditCookie-Wert , der ein Bearbeitungscookie für den neuen Kontext empfängt. Dieser Wert identifiziert den Kontext in verschiedenen Methoden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_OUTOFMEMORY	Ein Fehler bei der Speicherzuordnung ist aufgetreten.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Alle Verweise auf den Punkparameter werden freigegeben, wenn der Kontext zerstört wird oder wenn der Kontext mit der ITfDocumentMgr::P op-Methode aus dem Stapel entfernt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Itextstoreacp

ITfContext

ITfContextOwnerCompositionSink

ITfDocumentMgr

ITfDocumentMgr::P op

ITfTextInputProcessor::Activate

ITfThreadMgr::Activate

TfEditCookie