Функция HttpRemoveUrl (http.h)
Функция HttpRemoveUrl приводит к тому, что система останавливает маршрутизацию запросов, соответствующих указанной строке UrlPrefix , указанной очереди запросов.
Начиная с API HTTP-сервера версии 2.0, приложения должны вызывать HttpRemoveUrlFromUrlGroup для регистрации URL-адреса; HttpRemoveUrl не следует использовать.
Синтаксис
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
Параметры
[in] RequestQueueHandle
Дескриптор очереди запросов, из которой должна быть удалена регистрация URL-адреса. Создается очередь запросов, а ее дескриптор возвращается вызовом функции HttpCreateRequestQueue .
Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2): Дескриптор очереди запросов создается функцией HttpCreateHttpHandle .
[in] FullyQualifiedUrl
Указатель на строку UrlPrefix, зарегистрированную в указанной очереди запросов. Эта строка должна быть идентична той, которая передается в HttpAddUrl для регистрации UrlPrefix; даже изменение номенклатуры в IPv6-адресе не принимается.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращается один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Вызывающее приложение не имеет разрешения на удаление URL-адреса. |
|
Один или несколько предоставленных параметров находится в непригодной для использования форме. |
|
Недостаточно ресурсов для завершения операции. |
|
Не удалось найти указанный urlPrefix в базе данных регистрации. |
|
Код системной ошибки, определенный в WinError.h. |
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | http.h |
| Библиотека | Httpapi.lib |
| DLL | Httpapi.dll |