HTTPRemoveUrl 函式 (HTTP.h)
HttpRemoveUrl函式會使系統停止將符合指定UrlPrefix 字串的要求路由傳送至指定的要求佇列。
從 HTTP Server API 2.0 版開始，應用程式應該呼叫 HttpRemoveUrlFromUrlGroup 來註冊 URL;不應該使用 HttpRemoveUrl 。
語法
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
參數
[in] RequestQueueHandle
要從中移除 URL 註冊的要求佇列控制碼。 系統會建立要求佇列，並透過呼叫 HttpCreateRequestQueue 函式傳回其控制碼。
Windows Server 2003 SP1 和 Windows XP SP2： 要求佇列的控制碼是由 HttpCreateHttpHandle 函式所建立。
[in] FullyQualifiedUrl
登錄至指定要求佇列之 UrlPrefix 字串 的指標。 此字串必須與傳遞至 HttpAddUrl 的字串相同，才能註冊 UrlPrefix;即使不接受 IPv6 位址中的名詞變更。
傳回值
如果函式成功，傳回值會 NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
呼叫的應用程式沒有移除 URL 的許可權。 |
|
提供的一或多個參數格式為無法使用。 |
|
資源不足，無法完成作業。 |
|
在註冊資料庫中找不到指定的 UrlPrefix。 |
|
WinError.h 中定義的 系統錯誤碼 。 |
需求
| 最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | HTTP.h |
| 程式庫 | Httpapi.lib |
| Dll | Httpapi.dll |