Fungsi HttpSetServerSessionProperty (http.h)

Artikel
08/24/2023

Fungsi HttpSetServerSessionProperty mengatur properti sesi server baru atau memodifikasi properti yang ada pada sesi server yang ditentukan.

Sintaks

HTTPAPI_LINKAGE ULONG HttpSetServerSessionProperty(
  [in] HTTP_SERVER_SESSION_ID ServerSessionId,
  [in] HTTP_SERVER_PROPERTY   Property,
  [in] PVOID                  PropertyInformation,
  [in] ULONG                  PropertyInformationLength
);

Parameter

[in] ServerSessionId

Sesi server tempat properti diatur.

[in] Property

Anggota enumerasi HTTP_SERVER_PROPERTY yang menjelaskan jenis properti yang ditetapkan. Ini bisa menjadi salah satu dari berikut ini.

Properti	Makna
HttpServerStateProperty	Memodifikasi atau mengatur status sesi server. Status dapat diaktifkan atau dinonaktifkan; status default diaktifkan.
HttpServerTimeoutsProperty	Memodifikasi atau mengatur batas waktu habis koneksi sesi server.
HttpServerQosProperty	Memodifikasi atau mengatur pembatasan bandwidth untuk sesi server. Secara default, API Server HTTP tidak membatasi bandwidth. Catatan Nilai ini memetakan ke struktur HTTP_QOS_SETTING_INFO generik dengan QosType diatur ke HttpQosSettingTypeBandwidth.
HttpServerLoggingProperty	Mengaktifkan atau menonaktifkan pengelogan untuk sesi server. Properti ini hanya menetapkan W3C terpusat dan pengelogan biner terpusat. Secara default, pengelogan tidak diaktifkan.
HttpServerAuthenticationProperty	Mengaktifkan autentikasi sisi server mode kernel untuk skema autentikasi Dasar, NTLM, Negosiasi, dan Hash.
HttpServerExtendedAuthenticationProperty	Mengaktifkan autentikasi sisi server mode kernel untuk skema autentikasi Kerberos.
HttpServerChannelBindProperty	Mengaktifkan autentikasi sisi server yang menggunakan token pengikatan saluran (CBT).

[in] PropertyInformation

Penunjuk ke buffer yang berisi data properti.

pPropertyInformation menunjuk ke struktur data properti, yang tercantum dalam tabel berikut, berdasarkan properti yang diatur.

Properti	Struktur
HttpServerStateProperty	HTTP_STATE_INFO
HttpServerLoggingProperty	HTTP_LOGGING_INFO
HttpServerQosProperty	HTTP_QOS_SETTING_INFO
HttpServerTimeoutsProperty	HTTP_TIMEOUT_LIMIT_INFO
HttpServerAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerExtendedAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerChannelBindProperty	HTTP_CHANNEL_BIND_INFO

[in] PropertyInformationLength

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

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR

Jika fungsi gagal, fungsi akan mengembalikan salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Jenis properti yang ditentukan dalam parameter Properti tidak didukung untuk sesi server. Parameter pPropertyInformation adalah NULL. Parameter PropertyInformationLength adalah nol. Parameter ServerSessionId tidak berisi sesi server yang valid. Aplikasi tidak memiliki izin untuk mengatur properti sesi server. Hanya aplikasi yang membuat sesi server yang dapat mengatur properti.

Nilai

Makna

ERROR_INVALID_PARAMETER

Jenis properti yang ditentukan dalam parameter Properti tidak didukung untuk sesi server.

Parameter pPropertyInformation adalah NULL.

Parameter PropertyInformationLength adalah nol.

Parameter ServerSessionId tidak berisi sesi server yang valid.

Aplikasi tidak memiliki izin untuk mengatur properti sesi server. Hanya aplikasi yang membuat sesi server yang dapat mengatur properti.

Keterangan

Sesi server adalah kontainer konfigurasi tingkat atas untuk data konfigurasi yang berlaku untuk semua grup URL yang dibuat di bawahnya. Sesi server dibuat dengan HttpCreateServerSession.

Parameter pPropertyInformation menunjuk ke struktur konfigurasi untuk jenis properti yang diatur. Parameter PropertyInformationLength menentukan ukuran, dalam byte, dari struktur konfigurasi. Misalnya, saat mengatur HttpServerTimeoutsProperty , parameter pPropertyInformation harus menunjuk ke buffer yang setidaknya sama dengan ukuran struktur HTTP_TIMEOUT_LIMIT_INFO .

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

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty

Bagikan melalui