Fungsi HttpSetRequestQueueProperty (http.h)
Fungsi HttpSetRequestQueueProperty mengatur properti baru atau memodifikasi properti yang ada pada antrean permintaan yang diidentifikasi oleh handel yang ditentukan.
Sintaks
HTTPAPI_LINKAGE ULONG HttpSetRequestQueueProperty(
[in] HANDLE RequestQueueHandle,
[in] HTTP_SERVER_PROPERTY Property,
[in] PVOID PropertyInformation,
[in] ULONG PropertyInformationLength,
[in] ULONG Reserved1,
[in] PVOID Reserved2
);
Parameter
[in] RequestQueueHandle
Handel ke antrean permintaan tempat properti diatur. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .
[in] Property
Anggota enumerasi HTTP_SERVER_PROPERTY yang menjelaskan jenis properti yang ditetapkan. Ini harus menjadi salah satu hal berikut:
[in] PropertyInformation
Penunjuk ke buffer yang berisi informasi properti.
pPropertyInformation menunjuk ke salah satu jenis informasi properti berikut berdasarkan properti yang diatur.
Properti | Jenis Konfigurasi |
---|---|
HttpServerStateProperty | enumerasi HTTP_ENABLED_STATE |
HttpServerQueueLengthProperty | ULONG |
HttpServer503VerbosityProperty | enumerasi HTTP_503_RESPONSE_VERBOSITY |
[in] PropertyInformationLength
Panjangnya, dalam byte, dari buffer yang diacu oleh parameter pPropertyInformation .
[in] Reserved1
Dicadangkan. Harus nol.
[in] Reserved2
Dicadangkan. Harus NULL.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR.
Jika fungsi gagal, fungsi mengembalikan salah satu kode kesalahan berikut.
Nilai | Makna |
---|---|
|
Parameter Yang Dicadangkan bukan nol atau parameter pReserved bukan NULL.
Jenis properti yang ditentukan dalam parameter Properti tidak didukung untuk antrean permintaan. Parameter pPropertyInformation adalah NULL. Parameter PropertyInformationLength adalah nol. Aplikasi tidak memiliki izin untuk mengatur properti pada antrean permintaan. Hanya aplikasi yang membuat antrean permintaan yang dapat mengatur properti. |
|
Handel ke antrean permintaan adalah handel HTTP versi 1.0. Manajemen properti hanya didukung pada antrean permintaan HTTP versi 2.0 atau yang lebih baru. |
Persyaratan
Persyaratan | Nilai |
---|---|
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 |