Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The HttpRemoveUrl function causes the system to stop routing requests that match a specified UrlPrefix string to a specified request queue.
Starting with HTTP Server API Version 2.0, applications should call HttpRemoveUrlFromUrlGroup to register a URL; HttpRemoveUrl should not be used.
Syntax
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
Parameters
[in] RequestQueueHandle
The handle to the request queue from which the URL registration is to be removed. A request queue is created and its handle returned by a call to the HttpCreateRequestQueue function.
Windows Server 2003 with SP1 and Windows XP with SP2: The handle to the request queue is created by the HttpCreateHttpHandle function.
[in] FullyQualifiedUrl
A pointer to a UrlPrefix string registered to the specified request queue. This string must be identical to the one passed to HttpAddUrl to register the UrlPrefix; even a nomenclature change in an IPv6 address is not accepted.
Return value
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
| Value | Meaning |
|---|---|
|
The calling application does not have permission to remove the URL. |
|
One or more of the supplied parameters is in an unusable form. |
|
Insufficient resources to complete the operation. |
|
The specified UrlPrefix could not be found in the registration database. |
|
A system error code defined in WinError.h. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | http.h |
| Library | Httpapi.lib |
| DLL | Httpapi.dll |