Función HttpRemoveUrlFromUrlGroup (http.h)

Artículo
08/24/2023

La función HttpRemoveUrlFromUrlGroup quita la dirección URL especificada del grupo identificado por el identificador de grupo de direcciones URL. Esta función quita una o todas las direcciones URL del grupo.

Esta función reemplaza a la función HttpRemoveUrl de la versión HTTP 1.0.

Sintaxis

HTTPAPI_LINKAGE ULONG HttpRemoveUrlFromUrlGroup(
  [in] HTTP_URL_GROUP_ID UrlGroupId,
  [in] PCWSTR            pFullyQualifiedUrl,
  [in] ULONG             Flags
);

Parámetros

[in] UrlGroupId

Identificador del grupo de direcciones URL del que se quita la dirección URL especificada en pFullyQualifiedUrl .

[in] pFullyQualifiedUrl

Puntero a una cadena Unicode que contiene una cadena UrlPrefix con el formato correcto que identifica la dirección URL que se va a quitar.

Cuando se pasa HTTP_URL_FLAG_REMOVE_ALL en el parámetro Flags , todos los registros de direcciones URL existentes para el grupo de direcciones URL identificado en UrlGroupId se quitan del grupo. En este caso, pFullyQualifiedUrl debe ser NULL.

[in] Flags

Marcas de dirección URL que califican la dirección URL que se quita. Puede ser una de las siguientes marcas:

Marca de dirección URL	Significado
HTTP_URL_FLAG_REMOVE_ALL	Quita todas las direcciones URL registradas actualmente con el grupo de direcciones URL.

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
ERROR_INVALID_PARAMETER	El grupo de direcciones URL no existe. El parámetro Flags contiene una combinación no válida de marcas. Se estableció la marca HTTP_URL_FLAG_REMOVE_ALL y el parámetro pFullyQualifiedUrl no se estableció en NULL. La aplicación no tiene permiso para quitar las direcciones URL del grupo. Solo la aplicación que creó el grupo de direcciones URL puede quitar direcciones URL.
ERROR_ACCESS_DENIED	El proceso de llamada no tiene permiso para anular el registro de la dirección URL.
ERROR_FILE_NOT_FOUND	La dirección URL especificada no está registrada con el grupo de direcciones URL.

Valor

Significado

ERROR_INVALID_PARAMETER

El grupo de direcciones URL no existe.

El parámetro Flags contiene una combinación no válida de marcas.

Se estableció la marca HTTP_URL_FLAG_REMOVE_ALL y el parámetro pFullyQualifiedUrl no se estableció en NULL.

La aplicación no tiene permiso para quitar las direcciones URL del grupo. Solo la aplicación que creó el grupo de direcciones URL puede quitar direcciones URL.

ERROR_ACCESS_DENIED

El proceso de llamada no tiene permiso para anular el registro de la dirección URL.

ERROR_FILE_NOT_FOUND

La dirección URL especificada no está registrada con el grupo de direcciones URL.

Comentarios

La API de servidor HTTP admite aplicaciones existentes que usan los registros de direcciones URL de la versión 1.0; sin embargo, el nuevo desarrollo con la API del servidor HTTP debe usar HttpRemoveUrlFromUrlGroup; no use HttpRemoveUrl.

Las aplicaciones deben quitar la dirección URL agregada al grupo por HttpAddUrlToUrlGroup, cuando la dirección URL ya no es necesaria.

Requisitos

Requisito	Value
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