Función HttpRemoveUrl (http.h)
La función HttpRemoveUrl hace que el sistema detenga el enrutamiento de solicitudes que coinciden con una cadena UrlPrefix especificada en una cola de solicitudes especificada.
A partir de http Server API versión 2.0, las aplicaciones deben llamar a HttpRemoveUrlFromUrlGroup para registrar una dirección URL; No se debe usar HttpRemoveUrl .
Sintaxis
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
Parámetros
[in] RequestQueueHandle
Identificador de la cola de solicitudes desde la que se va a quitar el registro de la dirección URL. Se crea una cola de solicitudes y se devuelve su identificador mediante 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 UrlPrefix registrada en la cola de solicitudes especificada. Esta cadena debe ser idéntica a la pasada a HttpAddUrl para registrar el UrlPrefix; incluso no se acepta un cambio de nomenclatura en una dirección IPv6.
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 quitar la dirección URL. |
|
Uno o varios de los parámetros proporcionados están en forma inutilizable. |
|
Recursos insuficientes para completar la operación. |
|
No se encontró el valor de UrlPrefix especificado en la base de datos de registro. |
|
Código de error del sistema definido en WinError.h. |
Requisitos
| 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 |