Fungsi HttpCreateUrlGroup (http.h)

Artikel
08/24/2023

Fungsi HttpCreateUrlGroup membuat Grup URL di bawah sesi server yang ditentukan.

Sintaks

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

Parameter

[in] ServerSessionId

Pengidentifikasi sesi server tempat Grup URL dibuat.

[out] pUrlGroupId

Penunjuk ke variabel yang menerima ID Grup URL.

[in] Reserved

Dicadangkan. Harus nol.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR

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

Nilai	Makna
ERROR_INVALID_PARAMETER	Parameter ServerSessionId menunjukkan Sesi Server yang tidak ada. Parameter pUrlGroupId null. Parameter Yang Dipesan bukan nol.

Nilai

Makna

ERROR_INVALID_PARAMETER

Parameter ServerSessionId menunjukkan Sesi Server yang tidak ada.

Parameter pUrlGroupId null.

Parameter Yang Dipesan bukan nol.

Keterangan

Grup URL adalah kontainer konfigurasi untuk sekumpulan URL. Mereka dibuat di bawah sesi server dan mewarisi pengaturan konfigurasi sesi server. Saat parameter konfigurasi diatur pada Grup URL, parameter tersebut akan menggantikan konfigurasi yang diatur pada sesi server. Untuk informasi selengkapnya tentang konfigurasi pengaturan untuk Grup URL, lihat HttpSetUrlGroupProperty.

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.

Asosiasi Grup URL dengan antrean permintaan bersifat dinamis. Asosiasi dengan sesi server tidak dapat diubah hingga sesi server atau Grup URL dihapus. Saat sesi server dihapus, semua Grup URL terkait juga ditutup secara otomatis.

Grup URL awalnya dibuat sebagai grup kosong. URL harus ditambahkan ke grup dengan memanggil HttpAddUrlToUrlGroup.

Aplikasi dapat membuat beberapa Grup URL karena alasan berikut:

Untuk mengatur konfigurasi yang berbeda untuk bagian ruang nama URL yang berbeda tempatnya mendengarkan.
Untuk mengatur antrean permintaan terpisah untuk bagian ruang nama URL yang berbeda tempatnya mendengarkan.

Aplikasi harus menggabungkan URL ke dalam grup sebanyak mungkin; jika tidak, performa akan turun dan peningkatan konsumsi memori sistem akan memengaruhi skalabilitas.

HTTP Server API tidak mendukung I/O asinkron pada Grup URL.

Ketika grup URL tidak lagi diperlukan atau sebelum aplikasi berakhir, grup URL harus dihapus dengan memanggil HttpCloseUrlGroup.

Grup URL dibuat dengan versi yang sama dengan sesi server tempatnya dibuat.

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