Fungsi HttpSetUrlGroupProperty (http.h)

Artikel
08/24/2023

Fungsi HttpSetUrlGroupProperty mengatur properti baru atau memodifikasi properti yang ada pada Grup URL yang ditentukan.

Sintaks

HTTPAPI_LINKAGE ULONG HttpSetUrlGroupProperty(
  [in] HTTP_URL_GROUP_ID    UrlGroupId,
  [in] HTTP_SERVER_PROPERTY Property,
  [in] PVOID                PropertyInformation,
  [in] ULONG                PropertyInformationLength
);

Parameter

[in] UrlGroupId

ID Grup URL tempat properti diatur.

[in] Property

Anggota enumerasi HTTP_SERVER_PROPERTY yang menjelaskan jenis properti yang dimodifikasi atau diatur. Bisa jadi salah satu dari yang berikut:

Properti	Makna
HttpServerAuthenticationProperty	Mengaktifkan autentikasi sisi server untuk Grup URL menggunakan skema autentikasi Dasar, NTLM, Negosiasi, dan Hash.
HttpServerExtendedAuthenticationProperty	Mengaktifkan autentikasi sisi server untuk Grup URL menggunakan skema autentikasi Kerberos.
HttpServerQosProperty	Nilai ini memetakan ke struktur HTTP_QOS_SETTING_INFO generik dengan QosType diatur ke HttpQosSettingTypeBandwidth atau HttpQosSettingTypeConnectionLimit. Jika HttpQosSettingTypeBandwidth, memodifikasi atau mengatur pembatasan bandwidth untuk Grup URL. Jika HttpQosSettingTypeConnectionLimit, memodifikasi atau mengatur jumlah maksimum koneksi terutang yang disajikan untuk Grup URL kapan saja.
HttpServerBindingProperty	Memodifikasi atau mengatur asosiasi Grup URL dengan antrean permintaan.
HttpServerLoggingProperty	Memodifikasi atau mengatur pengelogan untuk Grup URL.
HttpServerStateProperty	Memodifikasi atau mengatur status Grup URL. Status dapat diaktifkan atau dinonaktifkan.
HttpServerTimeoutsProperty	Memodifikasi atau mengatur batas waktu habis koneksi untuk Grup URL.
HttpServerChannelBindProperty	Mengaktifkan autentikasi sisi server yang menggunakan token pengikatan saluran (CBT).

[in] PropertyInformation

Penunjuk ke buffer yang berisi informasi properti.

pPropertyInformation menunjuk ke salah satu struktur informasi properti berikut berdasarkan properti yang ditetapkan.

Properti	Struktur
HttpServerAuthenticatonProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerExtendedAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerQosProperty	HTTP_QOS_SETTING_INFO
HttpServerBindingProperty	HTTP_BINDING_INFO
HttpServerLoggingProperty	HTTP_LOGGING_INFO
HttpServerStateProperty	HTTP_STATE_INFO
HttpServerTimeoutsProperty	HTTP_TIMEOUT_LIMIT_INFO
HttpServerChannelBindProperty	HTTP_CHANNEL_BIND_INFO

[in] PropertyInformationLength

Panjangnya, dalam byte, dari buffer yang diacu oleh parameter pPropertyInformation .

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	Jenis properti yang ditentukan dalam parameter Properti tidak didukung untuk Grup URL. Parameter pPropertyInformation adalah NULL. Parameter PropertyInformationLength adalah nol. Parameter UrlGroupId tidak berisi sesi server yang valid. Aplikasi tidak memiliki izin untuk mengatur properti Grup URL. Hanya aplikasi yang membuat Grup URL yang dapat mengatur properti.

Nilai

Makna

ERROR_INVALID_PARAMETER

Jenis properti yang ditentukan dalam parameter Properti tidak didukung untuk Grup URL.

Parameter pPropertyInformation adalah NULL.

Parameter PropertyInformationLength adalah nol.

Parameter UrlGroupId tidak berisi sesi server yang valid.

Aplikasi tidak memiliki izin untuk mengatur properti Grup URL. Hanya aplikasi yang membuat Grup URL yang dapat mengatur properti.

Keterangan

Setelah Grup URL dibuat, grup tersebut harus dikaitkan dengan antrean permintaan untuk menerima permintaan. Untuk mengaitkan Grup URL dengan antrean permintaan, aplikasi memanggil HttpSetUrlGroupProperty dengan properti HttpServerBindingProperty . Jika properti ini tidak diatur, permintaan yang cocok untuk Grup URL tidak dikirimkan ke antrean permintaan dan HTTP Server API menghasilkan respons 503.

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