Bagikan melalui

CPL_INQUIRE 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).

lpcpli

Alamat struktur CPLINFO . Aplikasi harus mengisi struktur ini dengan pengidentifikasi sumber daya untuk ikon, nama pendek, deskripsi, dan nilai yang ditentukan pengguna yang terkait dengan kotak dialog.

Nilai kembali

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

Keterangan

Panel Kontrol mengirim pesan CPL_INQUIRE sekali untuk setiap kotak dialog yang didukung oleh aplikasi Anda. Panel Kontrol juga mengirim pesan CPL_NEWINQUIRE 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 .

Pesan CPL_NEWINQUIRE mengembalikan informasi dalam formulir yang tidak dapat di-cache oleh sistem. Untuk alasan ini, sebagian besar fungsi CPlApplet harus memproses CPL_INQUIRE dan mengabaikan CPL_NEWINQUIRE.

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 diperlukan ikon dan string tampilan, memungkinkan Anda menentukan informasi berdasarkan status komputer saat ini. Ini secara signifikan lebih lambat daripada menggunakan informasi yang di-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