Metode ISimpleFrameSite::P reMessageFilter (ocidl.h)

Artikel
03/05/2024

Menyediakan situs dengan kesempatan untuk memproses pesan yang diterima oleh jendela kontrol sendiri sebelum kontrol itu sendiri melakukan pemrosesan apa pun.

Sintaks

HRESULT PreMessageFilter(
  [in]  HWND    hWnd,
  [in]  UINT    msg,
  [in]  WPARAM  wp,
  [in]  LPARAM  lp,
  [out] LRESULT *plResult,
  [out] DWORD   *pdwCookie
);

Parameter

[in] hWnd

Handel jendela kontrol yang menerima pesan.

[in] msg

Pesan yang diterima oleh situs bingkai sederhana.

[in] wp

WPARAM pesan.

[in] lp

LPARAM pesan.

[out] plResult

Penunjuk ke variabel yang menerima hasil pemrosesan pesan.

[out] pdwCookie

Pointer ke variabel yang akan diteruskan ke ISimpleFrameSite::P ostMessageFilter jika dipanggil nanti. Parameter ini hanya boleh berisi data yang dialokasikan jika metode ini mengembalikan S_OK sehingga juga akan menerima panggilan ke PostMessageFilter yang dapat membebaskan alokasi. Pemanggil tidak bertanggung jawab atas apa pun yang dikembalikan dalam parameter ini.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Situs bingkai sederhana tidak akan menggunakan pesan dalam filter ini sehingga lebih banyak pemrosesan dapat terjadi.
S_FALSE	Situs telah memproses pesan dan tidak ada pemrosesan lebih lanjut yang harus terjadi.
E_NOTIMPL	Situs tidak melakukan pemfilteran pesan apa pun, menunjukkan bahwa PostMessageFilter tidak perlu dipanggil nanti.
E_POINTER	Alamat di plResult atau pdwCookie tidak valid.

Keterangan

Nilai pengembalian yang berhasil menunjukkan apakah situs ingin mengizinkan pemrosesan lebih lanjut. S_OK menunjukkan pemrosesan lebih lanjut, sedangkan S_FALSE berarti tidak memproses lebih lanjut. S_OK juga menunjukkan bahwa kontrol nantinya harus memanggil PostMessageFilter.

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	ocidl.h

Lihat juga

Situs ISimpleFrameSite

Bagikan melalui