TcDeleteFlow 函式 (traffic.h)
TcDeleteFlow 函式會刪除已使用 TcAddFlow 函式新增的流程。 客戶端應該在刪除流程之前先刪除所有相關聯的篩選,否則會傳回錯誤,而且函式不會刪除流程。
已註冊 DeleteFlowComplete 處理程式的流量控制用戶端 (允許流量控制呼叫 ClDeleteFlowComplete 回呼函式的機制,以警示用戶端已完成的流程刪除,) 預期傳回值ERROR_SIGNAL_PENDING。
語法
ULONG TcDeleteFlow(
[in] HANDLE FlowHandle
);
參數
[in] FlowHandle
流程的句柄,如先前對 TcAddFlow 函式的呼叫所接收。
傳回值
傳回碼 | Description |
---|---|
|
未發生錯誤的函式執行。 |
|
函式正以異步方式執行;用戶端會在新增流程或程式完成時,透過客戶端公開的 ClDeleteFlowComplete 函式來回呼叫。 |
|
流程句柄無效或 NULL。 |
|
先前對 TcModifyFlow、TcDeleteFlow 或 TcAddFlow 的函數調用對流程執行的動作尚未完成。 |
|
至少有一個與此流程相關聯的篩選。 |
備註
如果 TcDeleteFlow 函式傳回 ERROR_SIGNAL_PENDING,ClDeleteFlowComplete 函式將會在與 呼叫 TcDeleteFlow 函式的線程不同的線程上呼叫。
注意 使用 TcDeleteFlow 函式需要系統管理許可權。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | traffic.h |
程式庫 | Traffic.lib |
Dll | Traffic.dll |