Compartir a través de


Función HttpAddUrlToUrlGroup (http.h)

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.

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

Consulte también

Funciones de la API de servidor HTTP versión 2.0

HttpAddUrl

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

HttpSetUrlGroupProperty

Cadenas de UrlPrefix