Fungsi HttpCreateServerSession (http.h)
Fungsi HttpCreateServerSession membuat sesi server untuk versi yang ditentukan.
Sintaks
HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
[in] HTTPAPI_VERSION Version,
[out] PHTTP_SERVER_SESSION_ID ServerSessionId,
[in] ULONG Reserved
);
Parameter
[in] Version
Struktur HTTPAPI_VERSION yang menunjukkan versi sesi server. Untuk versi 2.0, deklarasikan instans struktur dan atur ke nilai yang telah ditentukan sebelumnya HTTPAPI_VERSION_2 sebelum meneruskannya ke HttpCreateServerSession.
Versi harus 2.0; HttpCreateServerSession tidak mendukung antrean permintaan versi 1.0.
[out] ServerSessionId
Penunjuk ke variabel yang menerima ID sesi server.
[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 |
|---|---|
|
Versi yang diteruskan tidak valid atau tidak didukung. |
|
Parameter pServerSessionId null atau Reserved bukan nol. |
Keterangan
Sesi server memiliki sekumpulan Grup URL. Mereka adalah kontainer konfigurasi tingkat atas untuk informasi konfigurasi yang berlaku untuk semua Grup URL yang dibuat di bawahnya. Untuk informasi selengkapnya tentang mengonfigurasi sesi server, lihat HttpSetServerSessionProperty.
HTTP Server API tidak mendukung I/O asinkron untuk sesi server.
Ketika sesi server tidak lagi diperlukan, atau sebelum aplikasi berakhir, aplikasi harus menghapus sesi server dengan memanggil HttpCloseServerSession. Saat sesi server dihapus, semua Grup URL terkait juga dihapus secara otomatis.
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 |
Lihat juga
Fungsi HTTP Server API Versi 2.0