Fungsi HttpSetRequestProperty (http.h)
Fungsi HttpSetRequestProperty menetapkan properti baru atau memodifikasi properti yang ada pada permintaan yang ditentukan.
Sintaks
HTTPAPI_LINKAGE ULONG HttpSetRequestProperty(
[in] HANDLE RequestQueueHandle,
[in] HTTP_OPAQUE_ID Id,
[in] HTTP_REQUEST_PROPERTY PropertyId,
[in] PVOID Input,
[in] ULONG InputPropertySize,
[in] LPOVERLAPPED Overlapped
);
Parameter
[in] RequestQueueHandle
Handel ke antrean permintaan tempat permintaan diterima. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .
[in] Id
ID buram permintaan. ID ini terletak di anggota RequestId dari struktur HTTP_REQUEST yang dikembalikan oleh HttpReceiveHttpRequest.
[in] PropertyId
Anggota enumerasi HTTP_REQUEST_PROPERTY yang menjelaskan jenis properti yang ditetapkan. Ini harus menjadi salah satu hal berikut:
| Properti | Makna | | HttpRequestPropertyStreamError | Mengatur kesalahan streaming pada permintaan. |
[in] Input
Penunjuk ke buffer yang berisi informasi properti.
Ini harus menunjuk ke salah satu jenis informasi properti berikut berdasarkan properti yang diatur.
| Properti | Jenis Konfigurasi | | HttpRequestPropertyStreamError | struktur HTTP_REQUEST_PROPERTY_STREAM_ERROR |
[in] InputPropertySize
Panjangnya, dalam byte, dari buffer yang diacu oleh parameter Input .
[in] Overlapped
Untuk panggilan asinkron, atur pOverlapped untuk menunjuk ke struktur YANG TUMPANG TINDIH ; untuk panggilan sinkron, atur ke NULL.
Panggilan sinkron memblokir hingga operasi selesai, 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.
Menampilkan nilai
Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.
Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan sistem.
Persyaratan
| Target Platform | Windows |
| Header | http.h |
| Pustaka | Httpapi.lib |
| DLL | Httpapi.dll |