Fungsi HttpCreateServerSession (http.h)

Artikel
08/24/2023

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
ERROR_REVISION_MISMATCH	Versi yang diteruskan tidak valid atau tidak didukung.
ERROR_INVALID_PARAMETER	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