Função HttpRemoveUrl (http.h)
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 |
|---|---|
|
O aplicativo de chamada não tem permissão para remover a URL. |
|
Um ou mais dos parâmetros fornecidos estão em uma forma inutilizável. |
|
Recursos insuficientes para concluir a operação. |
|
Não foi possível encontrar o UrlPrefix especificado no banco de dados de registro. |
|
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 |