Fungsi HttpSetServerSessionProperty (http.h)

  • Artikel

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.

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