httpRemoveUrl 函数 (http.h)
HttpRemoveUrl 函数会导致系统停止将指定 UrlPrefix 字符串与指定请求队列匹配的请求路由。
从 HTTP 服务器 API 版本 2.0 开始,应用程序应调用 HttpRemoveUrlFromUrlGroup 来注册 URL;不应使用 HttpRemoveUrl 。
语法
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
parameters
[in] RequestQueueHandle
要从中删除 URL 注册的请求队列的句柄。 创建请求队列,并通过调用 HttpCreateRequestQueue 函数返回其句柄。
带 SP1 的 Windows Server 2003 和 SP2 的 Windows XP: 请求队列的句柄由 HttpCreateHttpHandle 函数创建。
[in] FullyQualifiedUrl
指向注册到指定请求队列的 UrlPrefix 字符串 的指针。 此字符串必须与传递给 HttpAddUrl 以注册 UrlPrefix 的字符串相同;甚至不接受 IPv6 地址中的命名更改。
返回值
如果函数成功,则返回值 NO_ERROR。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
调用应用程序没有删除 URL 的权限。 |
|
提供的一个或多个参数以不可用的形式提供。 |
|
资源不足,无法完成操作。 |
|
在注册数据库中找不到指定的 UrlPrefix。 |
|
WinError.h 中定义的 系统错误代码 。 |
要求
最低受支持的客户端 | Windows Vista、Windows XP 和 SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | http.h |
Library | Httpapi.lib |
DLL | Httpapi.dll |