INTERNET_STATUS_CALLBACK fungsi panggilan balik (wininet.h)
Prototipe untuk fungsi panggilan balik status yang ditentukan aplikasi.
Jenis INTERNET_STATUS_CALLBACK menentukan penunjuk ke fungsi panggilan balik ini. InternetStatusCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
INTERNET_STATUS_CALLBACK InternetStatusCallback;
void InternetStatusCallback(
[in] HINTERNET hInternet,
[in] DWORD_PTR dwContext,
[in] DWORD dwInternetStatus,
[in] LPVOID lpvStatusInformation,
[in] DWORD dwStatusInformationLength
)
{...}
Parameter
[in] hInternet
Handel yang fungsi panggilan baliknya dipanggil.
[in] dwContext
Penunjuk ke variabel yang menentukan nilai konteks yang ditentukan aplikasi yang terkait dengan hInternet.
[in] dwInternetStatus
Kode status yang menunjukkan mengapa fungsi panggilan balik dipanggil. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Menutup koneksi ke server. Parameter lpvStatusInformation adalah NULL. |
|
Berhasil tersambung ke alamat soket (SOCKADDR) yang diacu oleh lpvStatusInformation. |
|
Menyambungkan ke alamat soket (SOCKADDR) yang ditujukkan oleh lpvStatusInformation. |
|
Berhasil menutup koneksi ke server. Parameter lpvStatusInformation adalah NULL. |
|
Mengambil konten dari cache. Berisi data tentang peristiwa cookie sebelumnya untuk URL seperti jika cookie diterima, ditolak, diturunkan, atau di-leash.
Parameter lpvStatusInformation adalah penunjuk ke struktur InternetCookieHistory . |
|
Menunjukkan jumlah cookie yang diterima, ditolak, diturunkan (diubah dari cookie persisten ke sesi), atau di-leash (hanya akan dikirim dalam konteks pihak pertama). Parameter lpvStatusInformation adalah DWORD dengan jumlah cookie yang diterima. |
|
Menunjukkan jumlah cookie yang dikirim atau ditekan, ketika permintaan dikirim. Parameter lpvStatusInformation adalah DWORD dengan jumlah cookie yang dikirim atau ditekan. |
|
Tidak diterapkan. |
|
Memberi tahu aplikasi klien bahwa proksi telah terdeteksi. |
|
Nilai handel ini telah dihentikan. pvStatusInformation berisi alamat handel yang sedang ditutup. Parameter lpvStatusInformation berisi alamat handel yang sedang ditutup. |
|
Digunakan oleh InternetConnect untuk menunjukkan telah membuat handel baru. Ini memungkinkan aplikasi memanggil InternetCloseHandle dari utas lain, jika koneksi terlalu lama. Parameter lpvStatusInformation berisi alamat handel HINTERNET . |
|
Menerima pesan kode status menengah (tingkat 100) dari server. |
|
Berhasil menemukan alamat IP nama yang terkandung dalam lpvStatusInformation. Parameter lpvStatusInformation menunjuk ke PCTSTR yang berisi nama host. |
|
Respons memiliki header P3P di dalamnya. |
|
Tidak diterapkan. |
|
Tidak diterapkan. |
|
Tidak diterapkan. |
|
Menunggu server merespons permintaan. Parameter lpvStatusInformation adalah NULL. |
|
Permintaan HTTP akan mengalihkan permintaan secara otomatis. Parameter lpvStatusInformation menunjuk ke URL baru. Pada titik ini, aplikasi dapat membaca data apa pun yang dikembalikan oleh server dengan respons pengalihan dan dapat mengkueri header respons. Ini juga dapat membatalkan operasi dengan menutup handel. Panggilan balik ini tidak dilakukan jika permintaan asli yang ditentukan INTERNET_FLAG_NO_AUTO_REDIRECT. |
|
Operasi asinkron telah selesai. Parameter lpvStatusInformation berisi alamat struktur INTERNET_ASYNC_RESULT . |
|
Berhasil mengirim permintaan informasi ke server. Parameter lpvStatusInformation menunjuk ke nilai DWORD yang berisi jumlah byte yang dikirim. |
|
Mencari alamat IP nama yang terkandung dalam lpvStatusInformation. Parameter lpvStatusInformation menunjuk ke PCTSTR yang berisi nama host. |
|
Berhasil menerima respons dari server. |
|
Mengirim permintaan informasi ke server. Parameter lpvStatusInformation adalah NULL. |
|
Dipindahkan antara situs aman (HTTPS) dan tidak aman (HTTP). Pengguna harus diberi tahu tentang perubahan ini; jika tidak, pengguna berisiko mengungkapkan informasi sensitif secara tidak sengaja. Ketika bendera ini diatur, parameter lpvStatusInformation menunjuk ke status DWORD yang berisi bendera tambahan. |
[in] lpvStatusInformation
Penunjuk ke informasi status tambahan. Saat bendera INTERNET_STATUS_STATE_CHANGE diatur, lpvStatusInformation menunjuk ke DWORD yang berisi satu atau beberapa bendera berikut:
[in] dwStatusInformationLength
Ukuran, dalam byte, dari data yang diacu oleh lpvStatusInformation.
Mengembalikan nilai
Tidak ada
Keterangan
Karena panggilan balik dilakukan selama pemrosesan permintaan, aplikasi harus menghabiskan sedikit waktu dalam fungsi panggilan balik untuk menghindari penurunan throughput data pada jaringan. Misalnya, menampilkan kotak dialog dalam fungsi panggilan balik bisa menjadi operasi panjang sehingga server mengakhiri permintaan.
Fungsi panggilan balik dapat dipanggil dalam konteks utas yang berbeda dari utas yang memulai permintaan.
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 | wininet.h |