Share via

Metode ISimpleFrameSite::P reMessageFilter (ocidl.h)

  • Artikel

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