Fungsi InternetSetStatusCallbackA (wininet.h)

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

Sintaksis

INTERNET_STATUS_CALLBACK InternetSetStatusCallbackA(
  HINTERNET                hInternet,
  INTERNET_STATUS_CALLBACK lpfnInternetCallback
);

Parameter

hInternet

Handel tempat panggilan balik diatur.

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.

Mengembalikan nilai

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.

Komentar

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 diwariskan 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 apa pun 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 saat parameter dwContext HttpOpenRequest diatur ke nol (INTERNET_NO_CALLBACK), atau handel koneksi saat handel dwContext InternetConnect 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.

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

 

Nota

Header wininet.h mendefinisikan InternetSetStatusCallback sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
Header	wininet.h
Library	wininet. Lib

Lihat juga

Common Functions

InternetStatusCallback

Fungsi WinINet