Función HttpCreateUrlGroup (http.h)
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 |
|---|---|
|
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 |