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。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
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
程式庫	Httpapi.lib
Dll	Httpapi.dll

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpAddUrl

HttpRemoveUrlFromUrlGroup