Fungsi HttpRemoveUrl (http.h)

Artikel
08/24/2023

Fungsi HttpRemoveUrl menyebabkan sistem menghentikan permintaan perutean yang cocok dengan string UrlPrefix tertentu dengan antrean permintaan tertentu.

Dimulai dengan HTTP Server API Versi 2.0, aplikasi harus memanggil HttpRemoveUrlFromUrlGroup untuk mendaftarkan URL; HttpRemoveUrl tidak boleh digunakan.

Sintaks

HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
  [in] HANDLE RequestQueueHandle,
  [in] PCWSTR FullyQualifiedUrl
);

Parameter

[in] RequestQueueHandle

Handel ke antrean permintaan tempat pendaftaran URL akan dihapus. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .

Windows Server 2003 dengan SP1 dan Windows XP dengan SP2: Handel ke antrean permintaan dibuat oleh fungsi HttpCreateHttpHandle .

[in] FullyQualifiedUrl

Penunjuk ke string UrlPrefix yang terdaftar ke antrean permintaan yang ditentukan. String ini harus identik dengan yang diteruskan ke HttpAddUrl untuk mendaftarkan UrlPrefix; bahkan perubahan nomenklatur dalam alamat IPv6 tidak diterima.

Mengembalikan 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_ACCESS_DENIED	Aplikasi panggilan tidak memiliki izin untuk menghapus URL.
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter yang disediakan dalam bentuk yang tidak dapat digunakan.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_FILE_NOT_FOUND	UrlPrefix yang ditentukan tidak dapat ditemukan di database pendaftaran.
Lainnya	Kode kesalahan sistem yang ditentukan dalam WinError.h.

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

HttpRemoveUrlFromUrlGroup

Share via