Fungsi InternetSetStatusCallback (wininet.h)

Fungsi InternetSetStatusCallback menyiapkan fungsi panggilan balik yang dapat dipanggil fungsi WinINet saat kemajuan dibuat selama operasi.

Sintaks

INTERNET_STATUS_CALLBACK InternetSetStatusCallback(
  [in] HINTERNET                hInternet,
  [in] INTERNET_STATUS_CALLBACK lpfnInternetCallback
);

Parameter

[in] hInternet

Handel tempat panggilan balik diatur.

[in] lpfnInternetCallback

Penunjuk ke fungsi panggilan balik untuk memanggil saat kemajuan dibuat, atau NULL untuk menghapus fungsi panggilan balik yang ada. Untuk informasi selengkapnya tentang fungsi panggilan balik, lihat InternetStatusCallback.

Nilai kembali

Mengembalikan fungsi panggilan balik status yang ditentukan sebelumnya jika berhasil, NULL jika tidak ada fungsi panggilan balik status yang ditentukan sebelumnya, atau INTERNET_INVALID_STATUS_CALLBACK jika fungsi panggilan balik tidak valid.

Keterangan

Fungsi sinkron dan asinkron menggunakan fungsi panggilan balik untuk menunjukkan kemajuan permintaan, seperti menyelesaikan nama, menyambungkan ke server, dan sebagainya. Fungsi panggilan balik diperlukan untuk operasi asinkron. Permintaan asinkron akan memanggil kembali ke aplikasi dengan INTERNET_STATUS_REQUEST_COMPLETE untuk menunjukkan permintaan telah selesai.

Fungsi panggilan balik dapat diatur pada handel apa pun, dan diwarisi oleh handel turunan. Fungsi panggilan balik dapat diubah menggunakan InternetSetStatusCallback, asalkan tidak ada permintaan tertunda yang perlu menggunakan nilai panggilan balik sebelumnya. Namun, perhatikan bahwa mengubah fungsi panggilan balik pada handel tidak mengubah panggilan balik pada handel turunan, seperti yang dikembalikan oleh InternetConnect. Anda harus mengubah fungsi panggilan balik di setiap tingkat.

Banyak fungsi WinINet melakukan beberapa operasi pada jaringan. Setiap operasi dapat memakan waktu untuk diselesaikan, dan masing-masing dapat gagal.

Terkadang diinginkan untuk menampilkan informasi status selama operasi jangka panjang. Anda dapat menampilkan informasi status dengan menyiapkan fungsi panggilan balik status Internet yang tidak dapat dihapus selama panggilan balik atau fungsi asinkron tertunda.

Setelah memulai InternetSetStatusCallback, fungsi panggilan balik dapat diakses dari dalam fungsi WinINet apa pun untuk memantau operasi jaringan intensif waktu.

Catatan Fungsi panggilan balik yang ditentukan dalam parameter lpfnInternetCallback tidak akan dipanggil pada operasi asinkron untuk handel permintaan ketika parameter dwContexthttpOpenRequest diatur ke nol (INTERNET_NO_CALLBACK), atau handel koneksi ketika handel dwContextInternetConnect diatur ke nol (INTERNET_NO_CALLBACK).

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

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
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Fungsi Umum

InternetStatusCallback

Fungsi WinINet