ITfDocumentMgr::CreateContext method (msctf.h)

Artikel
03/05/2024

Membuat objek konteks.

Sintaks

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

Parameter

[in] tidOwner

Pengidentifikasi klien. Untuk aplikasi, nilai ini disediakan oleh panggilan sebelumnya ke ITfThreadMgr::Activate. Untuk layanan teks, nilai ini disediakan dalam layanan teks metode ITfTextInputProcessor::Activate .

[in] dwFlags

Dicadangkan, harus nol.

[in] punk

Penunjuk ke objek yang mendukung antarmuka ITextStoreACP atau ITfContextOwnerCompositionSink . Nilai ini bisa NULL.

[out] ppic

Alamat penunjuk ITfContext yang menerima konteks.

[out] pecTextStore

Penunjuk ke nilai TfEditCookie yang menerima cookie edit untuk konteks baru. Nilai ini mengidentifikasi konteks dalam berbagai metode.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_OUTOFMEMORY	Terjadi kesalahan alokasi memori.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.

Keterangan

Semua referensi ke parameter punk dirilis ketika konteks dihancurkan atau ketika konteks dihapus dari tumpukan dengan metode ITfDocumentMgr::P op .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional