Função HttpRemoveUrl (http.h)

  • Artigo

A função HttpRemoveUrl faz com que o sistema interrompa as solicitações de roteamento que correspondem a uma cadeia de caracteres UrlPrefix especificada a uma fila de solicitações especificada.

A partir da versão 2.0 da API do Servidor HTTP, os aplicativos devem chamar HttpRemoveUrlFromUrlGroup para registrar uma URL; HttpRemoveUrl não deve ser usado.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
  [in] HANDLE RequestQueueHandle,
  [in] PCWSTR FullyQualifiedUrl
);

Parâmetros

[in] RequestQueueHandle

O identificador para a fila de solicitação da qual o registro de URL deve ser removido. Uma fila de solicitação é criada e seu identificador retornado por uma chamada para a função HttpCreateRequestQueue .

Windows Server 2003 com SP1 e Windows XP com SP2: O identificador para a fila de solicitação é criado pela função HttpCreateHttpHandle .

[in] FullyQualifiedUrl

Um ponteiro para uma cadeia de caracteres UrlPrefix registrada na fila de solicitações especificada. Essa cadeia de caracteres deve ser idêntica à passada para HttpAddUrl para registrar o UrlPrefix; até mesmo uma alteração de nomenclatura em um endereço IPv6 não é aceita.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor Significado
ERROR_ACCESS_DENIED
 O aplicativo de chamada não tem permissão para remover a URL.
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros fornecidos estão em uma forma inutilizável.
ERROR_NOT_ENOUGH_MEMORY
 Recursos insuficientes para concluir a operação.
ERROR_FILE_NOT_FOUND
 Não foi possível encontrar o UrlPrefix especificado no banco de dados de registro.
Outros
 Um código de erro do sistema definido em WinError.h.

Requisitos

   
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho http.h
Biblioteca Httpapi.lib
DLL Httpapi.dll

Confira também

Funções da API do Servidor HTTP versão 1.0

HttpAddUrl

HttpRemoveUrlFromUrlGroup