Fungsi InternetErrorDlg (wininet.h)
Menampilkan kotak dialog untuk kesalahan yang diteruskan ke InternetErrorDlg, jika ada kotak dialog yang sesuai. Jika bendera FLAGS_ERROR_UI_FILTER_FOR_ERRORS digunakan, fungsi juga memeriksa header untuk kesalahan tersembunyi dan menampilkan kotak dialog jika diperlukan.
Sintaks
DWORD InternetErrorDlg(
[in] HWND hWnd,
[in, out] HINTERNET hRequest,
[in] DWORD dwError,
[in] DWORD dwFlags,
[in, out] LPVOID *lppvData
);
Parameter
[in] hWnd
Tangani ke jendela induk untuk kotak dialog yang diperlukan. Jika tidak ada kotak dialog yang diperlukan dan FLAGS_ERROR_UI_FLAGS_NO_UI diteruskan ke dwFlags, maka parameter ini bisa null.
[in, out] hRequest
Tangani ke koneksi Internet yang digunakan dalam panggilan ke HttpSendRequest.
[in] dwError
Nilai kesalahan untuk menampilkan kotak dialog. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Memungkinkan pengguna untuk mengonfirmasi pengalihan. |
|
Menampilkan dialog yang menunjukkan bahwa skrip proksi otomatis tidak valid. |
|
Menampilkan dialog yang menanyakan kepada pengguna apakah akan memposting data yang diberikan pada saluran yang tidak aman. |
|
Server meminta sertifikat klien.
Nilai yang dikembalikan untuk kesalahan ini selalu ERROR_SUCCESS, terlepas dari apakah pengguna telah memilih sertifikat atau tidak. Jika pengguna belum memilih sertifikat, maka autentikasi klien anonim akan dicoba pada permintaan berikutnya. |
|
Memberi tahu pengguna zona yang menyeberang ke situs aman. |
|
Memberi tahu pengguna zona yang menyeberang dari situs yang aman. |
|
Memberi tahu pengguna bahwa data yang diposting sekarang sedang dialihkan ke situs yang tidak aman. |
|
Menampilkan kotak dialog yang meminta nama dan kata sandi pengguna. |
|
Menunjukkan bahwa sertifikat SSL Nama Umum (bidang nama host) salah. Menampilkan kotak dialog Nama Umum SSL Tidak Valid dan memungkinkan pengguna melihat sertifikat yang salah. |
|
Menampilkan peringatan kepada pengguna mengenai konten aman campuran dan tidak aman. |
|
Menampilkan dialog yang menanyakan kepada pengguna apakah akan memposting data yang diberikan pada saluran yang tidak aman. |
|
Menunjukkan bahwa sertifikat SSL Nama Umum (bidang nama host) salah. Menampilkan kotak dialog Nama Umum SSL Tidak Valid dan memungkinkan pengguna melihat sertifikat yang salah. Juga memungkinkan pengguna untuk memilih sertifikat sebagai respons terhadap permintaan server. |
|
Menampilkan peringatan kepada pengguna yang menunjukkan masalah dengan sertifikat server. |
|
Memberi tahu pengguna bahwa sertifikat SSL telah kedaluwarsa. |
|
Menampilkan peringatan kepada pengguna yang menunjukkan bahwa pemeriksaan pencabutan sertifikat server gagal. |
|
Menampilkan dialog yang menunjukkan bahwa sertifikat server dicabut. |
|
Menampilkan dialog yang menunjukkan bahwa skrip proksi otomatis tidak dapat diunduh. |
[in] dwFlags
Tindakan. Parameter ini bisa menjadi satu atau beberapa nilai berikut.
Nilai | Makna |
---|---|
|
Memindai header yang dikembalikan untuk kesalahan. Panggil InternetErrorDlg dengan bendera ini yang diatur setelah panggilan ke HttpSendRequest sehingga mendeteksi kesalahan tersembunyi. Kesalahan autentikasi, misalnya, biasanya disembunyikan karena panggilan ke HttpSendRequest berhasil diselesaikan, tetapi dengan memindai kode status, InternetErrorDlg dapat menentukan bahwa proksi atau server memerlukan autentikasi. |
|
Jika fungsi berhasil, menyimpan hasil kotak dialog di handel Internet. |
|
Mengkueri handel Internet untuk informasi yang diperlukan. Fungsi ini membangun struktur data yang sesuai untuk kesalahan tersebut. (Misalnya, untuk kegagalan Cert CN, fungsi mengambil sertifikat.) |
|
Menserialisasikan kotak dialog autentikasi untuk permintaan bersamaan pada entri cache kata sandi. Parameter lppvData harus berisi alamat pointer ke struktur INTERNET_AUTH_NOTIFY_DATA , dan klien harus menerapkan fungsi panggilan balik yang aman dan tidak memblokir utas. |
|
Memungkinkan penelepon untuk meneruskan NULL ke parameter hWnd tanpa kesalahan. Untuk digunakan dalam keadaan di mana tidak ada antarmuka pengguna yang diperlukan. |
[in, out] lppvData
Penunjuk ke alamat struktur data. Strukturnya bisa berbeda untuk setiap kesalahan yang perlu ditangani.
Mengembalikan nilai
Mengembalikan salah satu nilai berikut, atau nilai kesalahan sebaliknya.
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi berhasil diselesaikan.
Untuk informasi selengkapnya, lihat ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED di parameter dwError . |
|
Fungsi dibatalkan oleh pengguna. |
|
Ini menunjukkan bahwa fungsi perlu mengulangi permintaannya. Dalam kasus autentikasi ini menunjukkan bahwa pengguna mengklik tombol OK . |
|
Handel ke jendela induk tidak valid. |
Keterangan
Selalu beri tahu pengguna ketika salah satu peristiwa berikut terjadi:
- ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR
- ERROR_INTERNET_INVALID_CA
- ERROR_INTERNET_POST_IS_NON_SECURE
- ERROR_INTERNET_SEC_CERT_CN_INVALID
- ERROR_INTERNET_SEC_CERT_DATE_INVALID
Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wininet.h |
Pustaka | Wininet.lib |
DLL | Wininet.dll |