Fungsi HttpCreateHttpHandle (http.h)

Artikel
03/14/2023

Fungsi HttpCreateHttpHandle membuat antrean permintaan HTTP untuk aplikasi panggilan dan mengembalikan handel ke dalamnya.

Dimulai dengan HTTP Server API Versi 2.0, aplikasi harus memanggil HttpCreateRequestQueue untuk membuat antrean permintaan; HttpCreateHttpHandle tidak boleh digunakan.

Sintaks

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Parameter

[out] RequestQueueHandle

Penunjuk ke variabel yang menerima handel ke antrean permintaan.

[in] Reserved

Dicadangkan. Parameter ini harus nol.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_DLL_INIT_FAILED	Aplikasi panggilan tidak memanggil HttpInitialize sebelum memanggil fungsi ini.
Lainnya	Kode kesalahan sistem yang ditentukan dalam WinError.h.

Keterangan

Antrean permintaan memungkinkan aplikasi panggilan untuk menerima permintaan URL tertentu. Aplikasi panggilan menggunakan fungsi HttpAddUrl untuk menentukan URL yang harus menerima permintaan.

Aplikasi harus menggunakan satu antrean permintaan untuk menerima permintaan. Menggunakan beberapa antrean permintaan dari satu proses tidak meningkatkan waktu respons atau throughput.

Ketika aplikasi telah selesai menerima permintaan, aplikasi harus memanggil fungsi CloseHandle untuk menutup handel.

Persyaratan


Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	http.h
Pustaka	Httpapi.lib
DLL	Httpapi.dll

Lihat juga

Fungsi HTTP Server API Versi 1.0

HttpAddUrl

HttpCreateRequestQueue

Share via