Fungsi CoRegisterMessageFilter (objbase.h)

Mendaftar dengan OLE instans antarmuka IMessageFilter , yang akan digunakan untuk menangani masalah konkurensi pada utas saat ini. Hanya satu filter pesan yang dapat didaftarkan untuk setiap utas. Utas di apartemen multithreaded tidak dapat memiliki filter pesan.

Sintaks

HRESULT CoRegisterMessageFilter(
  [in, optional]  LPMESSAGEFILTER lpMessageFilter,
  [out, optional] LPMESSAGEFILTER *lplpMessageFilter
);

Parameter

[in, optional] lpMessageFilter

Penunjuk ke antarmuka IMessageFilter pada filter pesan. Filter pesan ini harus didaftarkan pada utas saat ini, menggantikan filter pesan sebelumnya (jika ada). Parameter ini bisa NULL, menunjukkan bahwa tidak ada filter pesan yang harus didaftarkan pada utas saat ini.

Perhatikan bahwa fungsi ini memanggil AddRef pada penunjuk antarmuka ke filter pesan.

[out, optional] lplpMessageFilter

Alamat variabel pointer IMessageFilter* yang menerima penunjuk antarmuka ke filter pesan yang terdaftar sebelumnya. Jika sebelumnya tidak ada filter pesan terdaftar untuk utas saat ini, nilai *lplpMessageFilter adalah NULL.

Nilai kembali

Jika instans berhasil didaftarkan atau dicabut, nilai yang dikembalikan S_OK; jika tidak, itu S_FALSE.

Keterangan

Untuk mencabut filter pesan terdaftar, berikan filter pesan sebelumnya (mungkin NULL) sebagai parameter lpMessageFilter ke CoRegisterMessageFilter.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	objbase.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

IMessageFilter