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
ERROR_ACCESS_DENIED	La aplicación que realiza la llamada no tiene permiso para quitar la dirección URL.
ERROR_INVALID_PARAMETER	Uno o varios de los parámetros proporcionados están en forma inutilizable.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_FILE_NOT_FOUND	No se encontró el valor de UrlPrefix especificado en la base de datos de registro.
Otros	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

Consulte también

Funciones de la API de servidor HTTP versión 1.0

HttpAddUrl

HttpRemoveUrlFromUrlGroup