Fungsi CommDlgExtendedError (commdlg.h)
Mengembalikan kode kesalahan kotak dialog umum. Kode ini menunjukkan kesalahan terbaru yang terjadi selama eksekusi salah satu fungsi kotak dialog umum.
Sintaks
DWORD CommDlgExtendedError();
Mengembalikan nilai
Jenis: DWORD
Jika panggilan terbaru ke fungsi kotak dialog umum berhasil, nilai yang dikembalikan tidak ditentukan. Jika fungsi kotak dialog umum mengembalikan FALSE karena pengguna menutup atau membatalkan kotak dialog, nilai yang dikembalikan adalah nol. Jika tidak, nilai yang dikembalikan adalah kode kesalahan bukan nol.
Fungsi CommDlgExtendedError dapat mengembalikan kode kesalahan umum untuk salah satu fungsi kotak dialog umum. Selain itu, ada kode kesalahan yang dikembalikan hanya untuk kotak dialog umum tertentu. Semua kode kesalahan ini didefinisikan dalam Cderr.h. Kode kesalahan umum berikut dapat dikembalikan untuk salah satu fungsi kotak dialog umum.
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Kotak dialog tidak dapat dibuat. Panggilan fungsi kotak dialog umum ke fungsi Kotak Dialog gagal. Misalnya, kesalahan ini terjadi jika panggilan kotak dialog umum menentukan handel jendela yang tidak valid. |
|
Fungsi kotak dialog umum gagal menemukan sumber daya tertentu. |
|
Fungsi kotak dialog umum gagal selama inisialisasi. Kesalahan ini sering terjadi ketika memori yang cukup tidak tersedia. |
|
Fungsi kotak dialog umum gagal memuat sumber daya tertentu. |
|
Fungsi kotak dialog umum gagal memuat string yang ditentukan. |
|
Fungsi kotak dialog umum gagal mengunci sumber daya tertentu. |
|
Fungsi kotak dialog umum tidak dapat mengalokasikan memori untuk struktur internal. |
|
Fungsi kotak dialog umum tidak dapat mengunci memori yang terkait dengan handel. |
|
Bendera ENABLETEMPLATE diatur di anggota Bendera dari struktur inisialisasi untuk kotak dialog umum yang sesuai, tetapi Anda gagal menyediakan handel instans yang sesuai. |
|
Bendera ENABLEHOOK diatur dalam anggota Bendera dari struktur inisialisasi untuk kotak dialog umum terkait, tetapi Anda gagal memberikan penunjuk ke prosedur kait yang sesuai. |
|
Bendera ENABLETEMPLATE diatur di anggota Bendera struktur inisialisasi untuk kotak dialog umum terkait, tetapi Anda gagal menyediakan templat yang sesuai. |
|
Fungsi RegisterWindowMessage mengembalikan kode kesalahan saat dipanggil oleh fungsi kotak dialog umum. |
|
Anggota lStructSize dari struktur inisialisasi untuk kotak dialog umum terkait tidak valid. |
Kode kesalahan berikut dapat dikembalikan untuk fungsi PrintDlg .
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Fungsi PrintDlg gagal ketika mencoba membuat konteks informasi. |
|
Anda memanggil fungsi PrintDlg dengan bendera DN_DEFAULTPRN yang ditentukan dalam anggota wDefault dari struktur DEVNAMES , tetapi printer yang dijelaskan oleh anggota struktur lain tidak cocok dengan printer default saat ini. Kesalahan ini terjadi ketika Anda menyimpan struktur DEVNAMES, dan pengguna mengubah printer default dengan menggunakan Panel Kontrol.
Untuk menggunakan printer yang dijelaskan oleh struktur DEVNAMES , kosongkan bendera DN_DEFAULTPRN dan panggil PrintDlg lagi. Untuk menggunakan printer default, ganti struktur DEVNAMES (dan struktur, jika ada) dengan NULL; dan hubungi PrintDlg lagi. |
|
Data dalam struktur DEVMODE dan DEVNAMES menjelaskan dua printer yang berbeda. |
|
Pengandar pencetak gagal menginisialisasi struktur DEVMODE . |
|
Fungsi PrintDlg gagal selama inisialisasi, dan tidak ada kode kesalahan yang diperluas yang lebih spesifik untuk menjelaskan kegagalan. Ini adalah kode kesalahan default generik untuk fungsi tersebut. |
|
Fungsi PrintDlg gagal memuat pengandar perangkat untuk pencetak yang ditentukan. |
|
Printer default tidak ada. |
|
Tidak ada pengandar pencetak yang ditemukan. |
|
Fungsi PrintDlg gagal mengurai string di bagian [perangkat] dari file WIN.INI. |
|
Bagian [perangkat] dari file WIN.INI tidak berisi entri untuk printer yang diminta. |
|
Bendera PD_RETURNDEFAULT ditentukan dalam anggota Bendera struktur PRINTDLG , tetapi anggota hDevMode atau hDevNames bukan NULL. |
|
Fungsi PrintDlg gagal memuat sumber daya yang diperlukan. |
Kode kesalahan berikut dapat dikembalikan untuk fungsi ChooseFont .
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Ukuran yang ditentukan dalam anggota nSizeMax dari struktur CHOOSEFONT kurang dari ukuran yang ditentukan dalam anggota nSizeMin . |
|
Tidak ada font. |
Kode kesalahan berikut dapat dikembalikan untuk fungsi GetOpenFileName dan GetSaveFileName .
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Buffer yang ditujukkan oleh anggota lpstrFile dari struktur OPENFILENAME terlalu kecil untuk nama file yang ditentukan oleh pengguna. Dua byte pertama buffer lpstrFile berisi nilai bilangan bulat yang menentukan ukuran yang diperlukan untuk menerima nama lengkap, dalam karakter. |
|
Nama file tidak valid. |
|
Upaya untuk mensubkelas kotak daftar gagal karena memori yang memadai tidak tersedia. |
Kode kesalahan berikut dapat dikembalikan untuk fungsi FindText dan ReplaceText .
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Anggota struktur FINDREPLACE menunjuk ke buffer yang tidak valid. |
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 | commdlg.h (sertakan Windows.h) |
| Pustaka | Comdlg32.lib |
| DLL | Comdlg32.dll |
| Set API | ext-ms-win-shell-comdlg32-l1-1-0 (diperkenalkan dalam Windows 10, versi 10.0.10240) |
Lihat juga
Konseptual
Referensi
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk