Функция HttpAddUrlToUrlGroup (http.h)

Статья
03/14/2023

Функция HttpAddUrlToUrlGroup добавляет указанный URL-адрес в группу URL-адресов, определяемую идентификатором группы URL-адресов.

Эта функция заменяет функцию HTTP версии 1.0 HttpAddUrl .

Синтаксис

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

Параметры

[in] UrlGroupId

Идентификатор группы ДЛЯ группы URL-адресов, в которую направляются запросы по указанному URL-адресу. Группа URL-адресов создается функцией HttpCreateUrlGroup .

[in] pFullyQualifiedUrl

Указатель на строку Юникода, содержащую правильно сформированную строку UrlPrefix, которая идентифицирует регистрируемый URL-адрес. Если вы не работаете от имени администратора, укажите номер порта больше 1024, в противном случае может возникнуть ошибка ERROR_ACCESS_DENIED.

[in, optional] UrlContext

Контекст, связанный с URL-адресом, зарегистрированным в этом вызове. Контекст URL-адреса возвращается в структуре HTTP_REQUEST с каждым запросом, полученным по URL-адресу, указанному в параметре pFullyQualifiedUrl .

[in] Reserved

Зарезервировано. Должен равняться нулю.

Возвращаемое значение

Если функция завершается успешно, она возвращает NO_ERROR

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

Значение	Значение
ERROR_INVALID_PARAMETER	UrlGroupId не существует. Параметр Reserved не равен нулю. Приложение не имеет разрешения на добавление URL-адресов в группу. Только приложение, создающее группу URL-адресов, может добавлять URL-адреса.
ERROR_ACCESS_DENIED	Вызывающий процесс не имеет разрешения на регистрацию URL-адреса.
ERROR_ALREADY_EXISTS	Указанный URL-адрес конфликтует с существующей регистрацией.

Значение

ERROR_INVALID_PARAMETER

UrlGroupId не существует.

Параметр Reserved не равен нулю.

Приложение не имеет разрешения на добавление URL-адресов в группу. Только приложение, создающее группу URL-адресов, может добавлять URL-адреса.

ERROR_ACCESS_DENIED

Вызывающий процесс не имеет разрешения на регистрацию URL-адреса.

ERROR_ALREADY_EXISTS

Указанный URL-адрес конфликтует с существующей регистрацией.

API HTTP-сервера поддерживает существующие приложения, использующие регистрацию URL-адресов версии 1.0, однако новые разработки с помощью API HTTP-сервера должны использовать HttpAddUrlToUrlGroup; Не следует использовать HttpAddUrl .

Приложение может добавить несколько URL-адресов в группу URL-адресов с помощью повторяющегося вызова HttpAddUrlToUrlGroup. Запросы, соответствующие указанному URL-адресу, направляются в очередь запросов, связанную с группой URL-адресов. Дополнительные сведения о том, как API HTTP-сервера сопоставляет URL-адреса запросов с зарегистрированными URL-адресами, см. в разделе Строки UrlPrefix.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	http.h
Библиотека	Httpapi.lib
DLL	Httpapi.dll