Fungsi HttpSetRequestQueueProperty (http.h)

Artikel
08/24/2023

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:

Properti	Makna
HttpServer503VerbosityProperty	Memodifikasi atau mengatur tingkat verbositas saat ini dari 503 respons yang dihasilkan untuk antrean permintaan.
HttpServerQueueLengthProperty	Memodifikasi atau menetapkan batas jumlah permintaan terutang dalam antrean permintaan.
HttpServerStateProperty	Memodifikasi atau mengatur status antrean permintaan. Status harus aktif atau tidak aktif.

[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
ERROR_INVALID_PARAMETER	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.
ERROR_NOT_SUPPORTED	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.

Nilai

Makna

ERROR_INVALID_PARAMETER

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.

ERROR_NOT_SUPPORTED

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

Lihat juga

Fungsi HTTP Server API Versi 2.0

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpShutdownRequestQueue