Fungsi HttpShutdownRequestQueue (http.h)
Fungsi HttpShutdownRequestQueue menghentikan permintaan antrean untuk proses antrean permintaan yang ditentukan. Panggilan terutang ke HttpReceiveHttpRequest dibatalkan.
Sintaks
HTTPAPI_LINKAGE ULONG HttpShutdownRequestQueue(
[in] HANDLE RequestQueueHandle
);
Parameter
[in] RequestQueueHandle
Handel ke antrean permintaan yang dimatikan. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .
Menampilkan nilai
Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR
Jika fungsi gagal, fungsi mengembalikan salah satu kode kesalahan berikut.
| Nilai | Makna |
|---|---|
|
Parameter ReqQueueHandle tidak berisi antrean permintaan yang valid.
Aplikasi tidak memiliki izin untuk mematikan antrean permintaan. |
Keterangan
HttpShutdownRequestQueue membatalkan permintaan yang beredar dan menghentikan semua pemrosesan pada proses antrean permintaan. Langkah-langkah berikut dilakukan ketika fungsi ini dipanggil:
- Proses antrean permintaan ditandai untuk pembersihan dan tidak ada permintaan baru yang dirutekan ke proses antrean permintaan.
- Jika proses panggilan adalah pengontrol, panggilan HttpWaitForDemandStart yang beredar dibatalkan.
- Panggilan HttpReceiveHttpRequest yang tertunda dari proses panggilan dibatalkan.
- Permintaan yang sudah terikat ke proses panggilan dibatalkan.
- Permintaan tertunda yang belum diraih yang diantrekan ke proses antrean permintaan dialihkan ke proses antrean permintaan lain. Jika tidak ada proses antrean permintaan lain yang tersedia, permintaan yang tertunda disimpan hingga antrean permintaan ditutup, atau proses antrean permintaan non-pengontrol lain diluncurkan.
- Panggilan HttpWaitForDisconnect yang tertunda yang dimulai oleh proses panggilan dibatalkan.
- Respons luar biasa yang ditunjukkan oleh proses panggilan tidak terpengaruh, respons tersebut diselesaikan dengan benar.
Ketahuilah bahwa jika handel antrean permintaan dibagikan oleh beberapa proses, HttpShutdownRequestQueue membatasi pembersihan ke proses panggilan. Proses lain yang saat ini bekerja pada antrean permintaan tidak terpengaruh.
HttpShutdownRequestQueue dapat digunakan oleh aplikasi untuk mendaur ulang proses antrean permintaan. Untuk tujuan ini, HttpShutdownRequestQueue dipanggil sebelum mengakhiri proses yang berbagi antrean permintaan dengan proses lain. Setelah HttpShutdownRequestQueue kembali, proses dapat dihentikan atau didaur ulang dengan aman.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | http.h |
| Pustaka | Httpapi.lib |
| DLL | Httpapi.dll |