Bagikan melalui


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
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

Lihat juga

Fungsi HTTP Server API Versi 2.0

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty