TcModifyFlow 函式 (traffic.h)

TcModifyFlow函式會修改現有的流程。呼叫 TcModifyFlow時，應該填入新的 Flowspec 參數和任何流量控制物件。

已註冊 ModifyFlowComplete 處理常式的流量控制用戶端 (允許流量控制呼叫 ClModifyFlowComplete 回呼函式的機制，以警示用戶端完成的流程修改，) 可能會預期傳回值ERROR_SIGNAL_PENDING。

語法

ULONG TcModifyFlow(
  [in] HANDLE       FlowHandle,
  [in] PTC_GEN_FLOW pGenericFlow
);

[in] FlowHandle

流程的控制碼，如先前呼叫 TcAddFlow 函式所接收。

[in] pGenericFlow

流程修改描述的指標。

傳回碼	Description
NO_ERROR	未發生錯誤的函式執行。
ERROR_SIGNAL_PENDING	函式正以非同步方式執行;用戶端將會透過用戶端公開的 ClModifyFlowComplete 函式在新增流程時或程式完成時呼叫。
ERROR_INVALID_HANDLE	介面控制碼無效。
ERROR_NOT_ENOUGH_MEMORY	系統記憶體不足。
ERROR_NOT_READY	先前函式呼叫TcAddFlow、TcModifyFlow 或 TcDeleteFlow在流程上執行的動作尚未完成。
ERROR_INVALID_PARAMETER	有一個參數無效。
ERROR_INVALID_SERVICE_TYPE	已提供未指定或不正確的 intserv 服務類型。
ERROR_INVALID_TOKEN_RATE	已提供未指定或不正確的 TokenRate 值。
ERROR_INVALID_PEAK_RATE	PeakBandwidth值無效。
ERROR_INVALID_SD_MODE	ShapeDiscardMode無效。
ERROR_INVALID_QOS_PRIORITY	優先順序值無效。
ERROR_INVALID_TRAFFIC_CLASS	流量類別值無效。
ERROR_NO_SYSTEM_RESOURCES	沒有足夠的資源可容納要求的流程。
ERROR_TC_OBJECT_LENGTH_INVALID	為 TC 物件指定的長度不正確。
ERROR_INVALID_DIFFSERV_FLOW	適用于 Diffserv 流程。表示 QOS_DIFFSERV 物件是以不正確參數傳遞。
ERROR_DS_MAPPING_EXISTS	適用于 Diffserv 流程。表示TC_GEN_FLOW中指定的QOS_DIFFSERV_RULE已套用至介面上的現有流程。
ERROR_INVALID_SHAPE_RATE	QOS_SHAPING_RATE是以不正確 ShapeRate 傳遞。
ERROR_INVALID_DS_CLASS	QOS_DS_CLASS 無效。
ERROR_NETWORK_UNREACHABLE	網路纜線未插入介面卡。

如果 TcModifyFlow 函式傳回ERROR_SIGNAL_PENDING， ClModifyFlowComplete 函式將會在與呼叫 TcModifyFlow 函式的執行緒不同的執行緒上呼叫。

注意使用 TcModifyFlow 函式需要系統管理許可權。