Fungsi HttpSendResponseEntityBody (http.h)
Fungsi HttpSendResponseEntityBody mengirimkan data badan entitas yang terkait dengan respons HTTP.
Sintaks
HTTPAPI_LINKAGE ULONG HttpSendResponseEntityBody(
[in] HANDLE RequestQueueHandle,
[in] HTTP_REQUEST_ID RequestId,
[in] ULONG Flags,
[in] USHORT EntityChunkCount,
[in] PHTTP_DATA_CHUNK EntityChunks,
[out] PULONG BytesSent,
[in] PVOID Reserved1,
[in] ULONG Reserved2,
[in] LPOVERLAPPED Overlapped,
[in, optional] PHTTP_LOG_DATA LogData
);
Parameter
[in] RequestQueueHandle
Handel ke antrean permintaan tempat permintaan yang ditentukan diambil. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .
Windows Server 2003 dengan SP1 dan Windows XP dengan SP2: Handel ke antrean permintaan dibuat oleh fungsi HttpCreateHttpHandle .
[in] RequestId
Pengidentifikasi permintaan HTTP yang sesuai dengan respons ini. Nilai ini dikembalikan dalam anggota RequestId dari struktur HTTP_REQUEST dengan panggilan ke fungsi HttpReceiveHttpRequest . Ini tidak bisa HTTP_NULL_ID.
[in] Flags
Parameter yang dapat menyertakan salah satu nilai bendera yang saling eksklusif berikut ini.
Bendera | Makna |
---|---|
|
Koneksi jaringan harus terputus setelah mengirim respons ini, mengesampingkan fitur koneksi persisten yang terkait dengan versi HTTP yang digunakan. Aplikasi harus menggunakan bendera ini untuk menunjukkan akhir entitas dalam kasus di mana panjang konten atau pengodean yang dipotong tidak digunakan. |
|
Data badan entitas tambahan untuk respons ini dikirim oleh aplikasi melalui satu atau beberapa panggilan berikutnya ke HttpSendResponseEntityBody. Panggilan terakhir kemudian mengatur bendera ini ke nol. |
|
Bendera ini memungkinkan buffering data dalam kernel berdasarkan per respons.
Ini harus digunakan oleh aplikasi yang melakukan I/O sinkron, atau oleh aplikasi yang melakukan I/O asinkron dengan tidak lebih dari satu pengiriman yang luar biasa pada satu waktu. Aplikasi yang menggunakan I/O asinkron yang mungkin memiliki lebih dari satu pengiriman terutang pada satu waktu tidak boleh menggunakan bendera ini. Ketika bendera ini diatur, bendera ini harus digunakan secara konsisten dalam panggilan ke fungsi HttpSendHttpResponse juga. Windows Server 2003: Bendera ini tidak didukung. Bendera ini baru untuk Windows Server 2003 dengan SP1. |
|
Mengaktifkan algoritma penamaan TCP hanya untuk pengiriman ini.
Windows Vista dan yang lebih baru: Bendera ini tidak didukung. |
|
Menentukan bahwa untuk permintaan rentang, konten respons lengkap diteruskan dan pemanggil ingin API HTTP memproses rentang dengan tepat.
Catatan Bendera ini hanya didukung untuk respons terhadap permintaan HTTP GET dan menawarkan subset fungsionalitas terbatas. Aplikasi yang memerlukan pemrosesan rentang penuh harus melakukannya dalam mode pengguna dan tidak mengandalkan HTTP.sys. Penggunaannya tidak disarankan.
Catatan Bendera ini didukung. |
|
Menentukan bahwa permintaan/respons tidak mematuhi HTTP dan semua byte berikutnya harus diperlakukan sebagai badan entitas. Aplikasi menentukan bendera ini ketika menerima permintaan peningkatan Soket Web dan menginformasikan HTTP.sys untuk memperlakukan data koneksi sebagai data buram.
Bendera ini hanya diperbolehkan ketika anggota StatusCodepHttpResponse adalah 101, beralih protokol. HttpSendResponseEntityBody mengembalikan ERROR_INVALID_PARAMETER untuk semua jenis respons HTTP lainnya jika bendera ini digunakan. Windows 8 dan yang lebih baru: Bendera ini didukung. |
[in] EntityChunkCount
Sejumlah struktur dalam array yang ditujukkan oleh pEntityChunks. Jumlah ini tidak boleh melebihi 9999.
[in] EntityChunks
Penunjuk ke array struktur HTTP_DATA_CHUNK yang akan dikirim sebagai data badan entitas.
[out] BytesSent
Pilihan. Penunjuk ke variabel yang menerima angka, dalam byte, dikirim jika fungsi beroperasi secara sinkron.
Saat melakukan panggilan asinkron menggunakan pOverlapped, atur pBytesSent ke NULL. Jika tidak, ketika pOverlapped diatur ke NULL, pBytesSent harus berisi alamat memori yang valid, dan tidak diatur ke NULL.
[in] Reserved1
Parameter ini dicadangkan dan harus NULL.
[in] Reserved2
Parameter ini dicadangkan dan harus nol.
[in] Overlapped
Untuk panggilan asinkron, atur pOverlapped untuk menunjuk ke struktur yang TUMPANG TINDIH ; untuk panggilan sinkron, atur ke NULL.
Panggilan sinkron memblokir hingga semua data respons yang ditentukan dalam parameter pEntityChunks dikirim, sedangkan panggilan asinkron segera mengembalikan ERROR_IO_PENDING dan aplikasi panggilan kemudian menggunakan port penyelesaian GetOverlappedResult atau I/O untuk menentukan kapan operasi selesai. Untuk informasi selengkapnya tentang menggunakan struktur YANG TUMPANG TINDIH untuk sinkronisasi, lihat Sinkronisasi dan Input dan Output yang Tumpang Tindih.
[in, optional] LogData
Penunjuk ke struktur HTTP_LOG_DATA yang digunakan untuk mencatat respons. Teruskan pointer ke struktur HTTP_LOG_FIELDS_DATA dan transmisikan ke PHTTP_LOG_DATA.
Ketahuilah bahwa bahkan ketika pengelogan diaktifkan pada Grup URL, atau sesi server, respons tidak akan dicatat kecuali aplikasi menyediakan struktur data bidang log.
Windows Server 2003 dan Windows XP dengan SP2: Parameter ini dicadangkan dan harus NULL.
Windows Vista dan Windows Server 2008: Parameter ini baru untuk Windows Vista, dan Windows Server 2008
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.
Jika fungsi digunakan secara asinkron, nilai pengembalian ERROR_IO_PENDING menunjukkan bahwa permintaan berikutnya belum siap dan diambil nanti melalui mekanisme penyelesaian I/O yang tumpang tindih normal.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
Nilai | Makna |
---|---|
|
Satu atau beberapa parameter yang disediakan dalam bentuk yang tidak dapat digunakan. |
|
Ada panggilan yang tertunda ke HttpSendHttpResponse atau HttpSendResponseEntityBody yang memiliki RequestId yang sama. |
|
Kode kesalahan sistem yang ditentukan dalam WinError.h. |
Keterangan
Jika header Content-length atau header Pengodean transfer tidak disertakan dalam header respons, aplikasi harus menunjukkan akhir respons dengan secara eksplisit menutup koneksi menggunakan bendera HTTP_SEND_RESPONSE_DISCONNECT .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | http.h |
Pustaka | Httpapi.lib |
DLL | Httpapi.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk