Bagikan melalui

Fungsi InternetErrorDlg (wininet.h)

  • Artikel

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
ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION
 Memungkinkan pengguna untuk mengonfirmasi pengalihan.
ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT
 Menampilkan dialog yang menunjukkan bahwa skrip proksi otomatis tidak valid.
ERROR_INTERNET_CHG_POST_IS_NON_SECURE
 Menampilkan dialog yang menanyakan kepada pengguna apakah akan memposting data yang diberikan pada saluran yang tidak aman.
ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED
 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.
ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR
 Memberi tahu pengguna zona yang menyeberang ke situs aman.
ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR
 Memberi tahu pengguna zona yang menyeberang dari situs yang aman.
ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR
 Memberi tahu pengguna bahwa data yang diposting sekarang sedang dialihkan ke situs yang tidak aman.
ERROR_INTERNET_INCORRECT_PASSWORD
 Menampilkan kotak dialog yang meminta nama dan kata sandi pengguna.
ERROR_INTERNET_INVALID_CA
 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.
ERROR_INTERNET_MIXED_SECURITY
 Menampilkan peringatan kepada pengguna mengenai konten aman campuran dan tidak aman.
ERROR_INTERNET_POST_IS_NON_SECURE
 Menampilkan dialog yang menanyakan kepada pengguna apakah akan memposting data yang diberikan pada saluran yang tidak aman.
ERROR_INTERNET_SEC_CERT_CN_INVALID
 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.
ERROR_INTERNET_SEC_CERT_ERRORS
 Menampilkan peringatan kepada pengguna yang menunjukkan masalah dengan sertifikat server.
ERROR_INTERNET_SEC_CERT_DATE_INVALID
 Memberi tahu pengguna bahwa sertifikat SSL telah kedaluwarsa.
ERROR_INTERNET_SEC_CERT_REV_FAILED
 Menampilkan peringatan kepada pengguna yang menunjukkan bahwa pemeriksaan pencabutan sertifikat server gagal.
ERROR_INTERNET_SEC_CERT_REVOKED
 Menampilkan dialog yang menunjukkan bahwa sertifikat server dicabut.
ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT
 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
FLAGS_ERROR_UI_FILTER_FOR_ERRORS
 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.
FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS
 Jika fungsi berhasil, menyimpan hasil kotak dialog di handel Internet.
FLAGS_ERROR_UI_FLAGS_GENERATE_DATA
 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.)
FLAGS_ERROR_UI_SERIALIZE_DIALOGS
 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.
FLAGS_ERROR_UI_FLAGS_NO_UI
 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
ERROR_SUCCESS
 Fungsi berhasil diselesaikan.

Untuk informasi selengkapnya, lihat ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED di parameter dwError .
ERROR_CANCELLED
 Fungsi dibatalkan oleh pengguna.
ERROR_INTERNET_FORCE_RETRY
 Ini menunjukkan bahwa fungsi perlu mengulangi permintaannya. Dalam kasus autentikasi ini menunjukkan bahwa pengguna mengklik tombol OK .
ERROR_INVALID_HANDLE
 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
Kecuali pengguna telah secara eksplisit memilih untuk tidak diberitahu tentang peristiwa ini, kegagalan untuk melakukannya mengekspos pengguna secara tidak sengaja terhadap risiko keamanan yang signifikan.

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).
 

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

Lihat juga

Mengaktifkan Fungsionalitas Internet

Fungsi WinINet