Fungsi HttpRemoveUrlFromUrlGroup (http.h)

Artikel
02/26/2024

Fungsi HttpRemoveUrlFromUrlGroup menghapus URL yang ditentukan dari grup yang diidentifikasi oleh ID Grup URL. Fungsi ini menghapus satu, atau semua URL dari grup.

Fungsi ini menggantikan fungsi HttpRemoveUrl versi HTTP 1.0.

Sintaks

HTTPAPI_LINKAGE ULONG HttpRemoveUrlFromUrlGroup(
  [in] HTTP_URL_GROUP_ID UrlGroupId,
  [in] PCWSTR            pFullyQualifiedUrl,
  [in] ULONG             Flags
);

Parameter

[in] UrlGroupId

ID grup URL tempat URL yang ditentukan dalam pFullyQualifiedUrl dihapus.

[in] pFullyQualifiedUrl

Penunjuk ke string Unicode yang berisi String UrlPrefix yang dibentuk dengan benar yang mengidentifikasi URL yang akan dihapus.

Saat HTTP_URL_FLAG_REMOVE_ALL diteruskan dalam parameter Bendera , semua pendaftaran URL yang ada untuk Grup URL yang diidentifikasi di UrlGroupId dihapus dari grup. Dalam hal ini, pFullyQualifiedUrl harus NULL.

[in] Flags

Bendera URL memenuhi syarat URL yang dihapus. Ini bisa menjadi salah satu bendera berikut:

Bendera URL	Makna
HTTP_URL_FLAG_REMOVE_ALL	Menghapus semua URL yang saat ini terdaftar di Grup URL.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR.

Jika fungsi gagal, fungsi mengembalikan salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Grup URL tidak ada. Parameter Bendera berisi kombinasi bendera yang tidak valid. Bendera HTTP_URL_FLAG_REMOVE_ALL diatur dan parameter pFullyQualifiedUrl tidak diatur ke NULL. Aplikasi tidak memiliki izin untuk menghapus URL dari Grup. Hanya aplikasi yang membuat Grup URL yang dapat menghapus URL.
ERROR_ACCESS_DENIED	Proses panggilan tidak memiliki izin untuk membatalkan pendaftaran URL.
ERROR_FILE_NOT_FOUND	URL yang ditentukan tidak terdaftar di Grup URL.

Nilai

Makna

ERROR_INVALID_PARAMETER

Grup URL tidak ada.

Parameter Bendera berisi kombinasi bendera yang tidak valid.

Bendera HTTP_URL_FLAG_REMOVE_ALL diatur dan parameter pFullyQualifiedUrl tidak diatur ke NULL.

Aplikasi tidak memiliki izin untuk menghapus URL dari Grup. Hanya aplikasi yang membuat Grup URL yang dapat menghapus URL.

ERROR_ACCESS_DENIED

Proses panggilan tidak memiliki izin untuk membatalkan pendaftaran URL.

ERROR_FILE_NOT_FOUND

URL yang ditentukan tidak terdaftar di Grup URL.

Keterangan

HTTP Server API mendukung aplikasi yang ada menggunakan pendaftaran URL versi 1.0, namun, pengembangan baru dengan HTTP Server API harus menggunakan HttpRemoveUrlFromUrlGroup; jangan gunakan HttpRemoveUrl.

Aplikasi harus menghapus URL yang ditambahkan ke grup oleh HttpAddUrlToUrlGroup, ketika URL tidak lagi diperlukan.

Persyaratan

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