Поделиться через

Функция 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.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет разрешения на удаление URL-адреса.
ERROR_INVALID_PARAMETER
 Один или несколько предоставленных параметров находится в непригодной для использования форме.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно ресурсов для завершения операции.
ERROR_FILE_NOT_FOUND
 Не удалось найти указанный urlPrefix в базе данных регистрации.
Другое
 Код системной ошибки, определенный в WinError.h.

Требования

   
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header http.h
Библиотека Httpapi.lib
DLL Httpapi.dll

См. также раздел

Функции API HTTP-сервера версии 1.0

HttpAddUrl

HttpRemoveUrlFromUrlGroup