Fungsi HttpCreateUrlGroup (http.h)
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 |
|---|---|
|
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 |