Metode ITfSource::AdviseSink (msctf.h)

Artikel
03/08/2023

Menginstal sink saran.

Sintaks

HRESULT AdviseSink(
  [in]  REFIID   riid,
  [in]  IUnknown *punk,
  [out] DWORD    *pdwCookie
);

Parameter

[in] riid

Mengidentifikasi jenis sink saran untuk diinstal.

Parameter ini dapat menjadi salah satu nilai berikut ketika objek ITfSource diperoleh dari objek ITfThreadMgr .

Parameter ini dapat menjadi salah satu nilai berikut ketika objek ITfSource diperoleh dari objek ITfContext .

Nilai	Makna
IID_ITfActiveLanguageProfileNotifySink	Menginstal sink saran ITfActiveLanguageProfileNotifySink .
IID_ITfDisplayAttributeNotifySink	Menginstal sink saran ITfDisplayAttributeNotifySink .
IID_ITfKeyTraceEventSink	Menginstal sink saran ITfKeyTraceEventSink .
IID_ITfPreservedKeyNotifySink	Menginstal sink saran ITfPreservedKeyNotifySink .
IID_ITfThreadFocusSink	Menginstal sink saran ITfThreadFocusSink .
IID_ITfThreadMgrEventSink	Menginstal sink saran ITfThreadMgrEventSink .

[in] punk

Penunjuk IUnknown sink saran.

[out] pdwCookie

Alamat nilai DWORD yang menerima cookie identifikasi. Nilai ini digunakan untuk menghapus instalan sink saran dalam panggilan berikutnya ke ITfSource::UnadviseSink. Menerima (DWORD)-1 jika terjadi kegagalan.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
CONNECT_E_CANNOTCONNECT	Sink saran tidak dapat diinstal.
CONNECT_E_ADVISELIMIT	Jumlah maksimum sink saran telah tercapai.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_OUTOFMEMORY	Terjadi kegagalan alokasi memori.

Persyaratan


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