Fungsi HttpRemoveUrl (http.h)
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 |
---|---|
|
Aplikasi panggilan tidak memiliki izin untuk menghapus URL. |
|
Satu atau beberapa parameter yang disediakan dalam bentuk yang tidak dapat digunakan. |
|
Sumber daya tidak cukup untuk menyelesaikan operasi. |
|
UrlPrefix yang ditentukan tidak dapat ditemukan di database pendaftaran. |
|
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 |