Función HttpRemoveUrl (http.h)

  • Artículo

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