Función HttpAddUrlToUrlGroup (http.h)

Artículo
08/24/2023

La función HttpAddUrlToUrlGroup agrega la dirección URL especificada al grupo de direcciones URL identificado por el identificador de grupo de direcciones URL.

Esta función reemplaza a la función HttpAddUrl de la versión HTTP 1.0.

Sintaxis

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

Parámetros

[in] UrlGroupId

Identificador de grupo del grupo de direcciones URL al que se enrutan las solicitudes de la dirección URL especificada. La función HttpCreateUrlGroup crea el grupo de direcciones URL.

[in] pFullyQualifiedUrl

Puntero a una cadena Unicode que contiene una cadena UrlPrefix con el formato correcto que identifica la dirección URL que se va a registrar. Si no se ejecuta como administrador, especifique un número de puerto mayor que 1024; de lo contrario, puede obtener un error de ERROR_ACCESS_DENIED.

[in, optional] UrlContext

Contexto asociado a la dirección URL registrada en esta llamada. El contexto de dirección URL se devuelve en la estructura HTTP_REQUEST con cada solicitud recibida en la dirección URL especificada en el parámetro pFullyQualifiedUrl .

[in] Reserved

Reservado. Debe ser cero.

Valor devuelto

Si la función se ejecuta correctamente, devuelve NO_ERROR

Si se produce un error en la función, devuelve uno de los siguientes códigos de error.

Valor	Significado
ERROR_INVALID_PARAMETER	UrlGroupId no existe. El parámetro Reserved no es cero. La aplicación no tiene permiso para agregar direcciones URL al grupo. Solo la aplicación que creó el grupo de direcciones URL puede agregar direcciones URL.
ERROR_ACCESS_DENIED	El proceso de llamada no tiene permiso para registrar la dirección URL.
ERROR_ALREADY_EXISTS	La dirección URL especificada entra en conflicto con un registro existente.

Valor

Significado

ERROR_INVALID_PARAMETER

UrlGroupId no existe.

El parámetro Reserved no es cero.

La aplicación no tiene permiso para agregar direcciones URL al grupo. Solo la aplicación que creó el grupo de direcciones URL puede agregar direcciones URL.

ERROR_ACCESS_DENIED

El proceso de llamada no tiene permiso para registrar la dirección URL.

ERROR_ALREADY_EXISTS

La dirección URL especificada entra en conflicto con un registro existente.

Comentarios

La API de servidor HTTP admite aplicaciones existentes que usan registros de direcciones URL de la versión 1.0; sin embargo, el nuevo desarrollo con la API del servidor HTTP debe usar HttpAddUrlToUrlGroup; No se debe usar HttpAddUrl .

Una aplicación puede agregar varias direcciones URL a un grupo de direcciones URL mediante llamadas repetidas a HttpAddUrlToUrlGroup. Las solicitudes que coinciden con la dirección URL especificada se enrutan a la cola de solicitudes asociada al grupo de direcciones URL. Para obtener más información sobre cómo la API del servidor HTTP coincide con las direcciones URL de solicitud a las direcciones URL registradas, consulte Cadenas de urlPrefix.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	http.h
Library	Httpapi.lib
Archivo DLL	Httpapi.dll