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

如果函数失败,则返回值为以下错误代码之一。

含义
ERROR_ACCESS_DENIED
调用应用程序没有删除 URL 的权限。
ERROR_INVALID_PARAMETER
提供的一个或多个参数以不可用的形式提供。
ERROR_NOT_ENOUGH_MEMORY
资源不足,无法完成操作。
ERROR_FILE_NOT_FOUND
在注册数据库中找不到指定的 UrlPrefix。
其他
WinError.h 中定义的 系统错误代码

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 http.h
Library Httpapi.lib
DLL Httpapi.dll

另请参阅

HTTP 服务器 API 版本 1.0 函数

HttpAddUrl

HttpRemoveUrlFromUrlGroup