Función HttpAddUrl (http.h)
La función HttpAddUrl registra una dirección URL determinada para que las solicitudes que coincidan con ella se enrutan a una cola de solicitudes de API del servidor HTTP especificada. Una aplicación puede registrar varias direcciones URL en una sola cola de solicitudes mediante llamadas repetidas a HttpAddUrl. 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.
A partir de http Server API versión 2.0, las aplicaciones deben llamar a HttpAddUrlToUrlGroup para registrar una dirección URL; No se debe usar HttpAddUrl .
Sintaxis
HTTPAPI_LINKAGE ULONG HttpAddUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl,
PVOID Reserved
);
Parámetros
[in] RequestQueueHandle
Identificador de la cola de solicitudes a la que se enrutarán las solicitudes de la dirección URL especificada. Se crea una cola de solicitudes y su identificador devuelto por una llamada a la función HttpCreateRequestQueue .
Windows Server 2003 con SP1 y Windows XP con SP2: El identificador de la cola de solicitudes se crea mediante la función HttpCreateHttpHandle .
[in] FullyQualifiedUrl
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.
Reserved
Reservados; debe ser NULL.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
La aplicación que realiza la llamada no tiene permiso para registrar la dirección URL. |
|
La aplicación que realiza la llamada no llamó a HttpInitialize antes de llamar a esta función. |
|
Uno de los parámetros no es válido. |
|
UrlPrefix especificado entra en conflicto con un registro existente. |
|
Recursos insuficientes para completar la operación. |
|
Código de error del sistema definido en WinError.h. |
Comentarios
Como se indica en el tema Cadenas urlPrefix , la especificación de esquema del urlPrefix que se va a registrar debe ser "http" o "https" en minúsculas. Ninguna otra subcadena es válida.
Además, no es posible registrar direcciones URL que tengan esquemas diferentes en el mismo puerto. Es decir, los esquemas "http" y "https" no pueden coexistir en un puerto.
Tenga en cuenta también que HttpAddUrl registra cualquier urlPrefix que se le pase siempre que la cadena tenga un formato correcto. La aplicación debe controlar cualquier validación de existencia, accesibilidad, propiedad u otra característica del espacio de nombres de dirección URL especificado.
Para liberar los recursos asignados como resultado del registro realizado por HttpAddUrl, realice una llamada coincidente a la función HttpRemoveUrl cuando la aplicación haya terminado con el espacio de nombres implicado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | http.h |
| Library | Httpapi.lib |
| Archivo DLL | Httpapi.dll |