Bagikan melalui

CPL_NEWINQUIRE pesan

  • Artikel

Dikirim ke fungsi CPlApplet dari aplikasi Panel Kontrol untuk meminta informasi tentang kotak dialog yang didukung aplikasi.

Parameter

uAppNum

Nomor kotak dialog. Angka ini harus dalam rentang nol hingga satu kurang dari nilai yang dikembalikan sebagai respons terhadap pesan CPL_GETCOUNT (CPL_GETCOUNT – 1).

lpncpli

Alamat struktur NEWCPLINFO . Aplikasi Panel Kontrol harus mengisi struktur ini dengan informasi tentang kotak dialog.

Nilai kembali

Jika fungsi CPlApplet berhasil memproses pesan ini, fungsi tersebut harus mengembalikan nol.

Keterangan

Untuk performa yang lebih baik, sebagian besar aplikasi harus mengabaikan CPL_NEWINQUIRE dan memproses pesan CPL_INQUIRE sebagai gantinya.

Panel Kontrol mengirim pesan CPL_NEWINQUIRE sekali untuk setiap kotak dialog yang didukung oleh aplikasi Anda. Panel Kontrol juga mengirim pesan CPL_INQUIRE untuk setiap kotak dialog. Pesan-pesan ini dikirim segera setelah pesan CPL_GETCOUNT . Namun, sistem tidak menjamin urutan pengiriman pesan CPL_INQUIRE dan CPL_NEWINQUIRE .

Anda dapat melakukan inisialisasi untuk kotak dialog saat Menerima CPL_INQUIRE. Jika Anda harus mengalokasikan memori, lakukan sebagai respons terhadap pesan CPL_INIT .

CPL_INQUIRE adalah pesan yang disukai. Ini karena CPL_NEWINQUIRE mengembalikan informasi dalam bentuk yang tidak dapat di-cache oleh sistem. Akibatnya, aplikasi yang memproses CPL_NEWINQUIRE harus dimuat setiap kali Panel Kontrol membutuhkan informasi, yang mengakibatkan penurunan performa yang signifikan.

Satu-satunya aplikasi yang harus menggunakan CPL_NEWINQUIRE adalah aplikasi yang perlu mengubah ikon atau string tampilannya berdasarkan status komputer. Dalam hal ini, handler CPL_INQUIRE Anda harus menentukan nilai CPL_DYNAMIC_RES untuk anggota idIcon, idName, atau idInfo dari struktur CPLINFO , daripada menentukan pengidentifikasi sumber daya yang valid. Ini menyebabkan Panel Kontrol mengirim pesan CPL_NEWINQUIRE setiap kali dibutuhkan ikon dan string tampilan, memungkinkan Anda menentukan informasi berdasarkan status komputer saat ini. Tentu saja, ini secara signifikan lebih lambat daripada menggunakan informasi cache.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows XP [hanya aplikasi desktop]
Server minimum yang didukung
 Windows 2000 Server [hanya aplikasi desktop]
Header
Cpl.h