Struktur NEWCPLINFOW (cpl.h)
Berisi informasi sumber daya dan nilai yang ditentukan aplikasi untuk kotak dialog yang didukung oleh aplikasi Panel Kontrol.
Sintaks
typedef struct tagNEWCPLINFOW {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHelpContext;
LONG_PTR lData;
HICON hIcon;
WCHAR szName[32];
WCHAR szInfo[64];
WCHAR szHelpFile[128];
} NEWCPLINFOW, *LPNEWCPLINFOW;
Anggota
dwSize
Jenis: DWORD
Panjang struktur, dalam byte.
dwFlags
Jenis: DWORD
Anggota ini diabaikan.
dwHelpContext
Jenis: DWORD
Anggota ini diabaikan.
lData
Jenis: LONG_PTR
Penunjuk ke data yang ditentukan oleh aplikasi. Ketika Panel Kontrol mengirim pesan CPL_DBLCLK dan CPL_STOP, CPL_STOP meneruskan nilai ini kembali ke aplikasi Anda.
hIcon
Jenis: HICON
Pengidentifikasi ikon yang mewakili kotak dialog. Ikon ini dimaksudkan untuk ditampilkan oleh aplikasi yang mengontrol aplikasi Panel Kontrol.
szName[32]
Jenis: TCHAR[32]
String null-terminated yang berisi nama kotak dialog. Nama ini dimaksudkan untuk ditampilkan di bawah ikon.
szInfo[64]
Jenis: TCHAR[64]
String yang dihentikan null yang berisi deskripsi kotak dialog. Deskripsi dimaksudkan untuk ditampilkan saat ikon untuk kotak dialog dipilih.
szHelpFile[128]
Jenis: TCHAR[128]
Anggota ini diabaikan.
Keterangan
Fungsi CPlApplet dari aplikasi Panel Kontrol mengembalikan informasi ini ke Panel Kontrol sebagai respons terhadap pesan CPL_NEWINQUIRE.
Catatan
Header cpl.h mendefinisikan NEWCPLINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
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 |