Función HttpCreateUrlGroup (http.h)

Artículo
08/24/2023

La función HttpCreateUrlGroup crea un grupo de direcciones URL en la sesión de servidor especificada.

Sintaxis

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

Parámetros

[in] ServerSessionId

Identificador de la sesión del servidor en la que se crea el grupo de direcciones URL.

[out] pUrlGroupId

Puntero a la variable que recibe el identificador del grupo de direcciones URL.

[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	El parámetro ServerSessionId indica una sesión de servidor no existente. El parámetro pUrlGroupId es null. El parámetro Reserved es distinto de cero.

Valor

Significado

ERROR_INVALID_PARAMETER

El parámetro ServerSessionId indica una sesión de servidor no existente.

El parámetro pUrlGroupId es null.

El parámetro Reserved es distinto de cero.

Comentarios

Los grupos de direcciones URL son contenedores de configuración para un conjunto de direcciones URL. Se crean en la sesión del servidor y heredan las opciones de configuración de la sesión de servidor. Cuando se establece un parámetro de configuración en el grupo de direcciones URL, invalida el conjunto de configuración en la sesión del servidor. Para obtener más información sobre las configuraciones de configuración para el grupo de direcciones URL, vea HttpSetUrlGroupProperty.

Una vez creado el grupo de direcciones URL, debe estar asociado a una cola de solicitudes para recibir solicitudes. Para asociar el grupo de direcciones URL a una cola de solicitudes, la aplicación llama a HttpSetUrlGroupProperty con la propiedad HttpServerBindingProperty . Si no se establece esta propiedad, las solicitudes coincidentes para el grupo de direcciones URL no se entregan a una cola de solicitudes y la API del servidor HTTP genera una respuesta 503.

La asociación de grupo de direcciones URL con una cola de solicitudes es dinámica. La asociación con la sesión de servidores no se puede cambiar hasta que se elimine la sesión del servidor o el grupo de direcciones URL. Cuando se elimina una sesión de servidor, todos los grupos de direcciones URL asociados también se cierran automáticamente.

El grupo de direcciones URL se crea inicialmente como un grupo vacío. Las direcciones URL se deben agregar al grupo llamando a HttpAddUrlToUrlGroup.

La aplicación puede crear varios grupos de direcciones URL por los siguientes motivos:

Para establecer configuraciones distintas para diferentes partes del espacio de nombres de dirección URL en la que está escuchando.
Para establecer colas de solicitudes independientes para diferentes partes del espacio de nombres de dirección URL en la que está escuchando.

Las aplicaciones deben combinar direcciones URL en grupos tanto como sea posible; De lo contrario, el rendimiento se degradará y aumentará el consumo de memoria del sistema afectará a la escalabilidad.

La API del servidor HTTP no admite E/S asincrónica en grupos de direcciones URL.

Cuando el grupo de direcciones URL ya no es necesario o antes de que la aplicación finalice, debe eliminar el grupo de direcciones URL llamando a HttpCloseUrlGroup.

El grupo de direcciones URL se crea con la misma versión que la sesión del servidor en la que se crea.

Requisitos


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