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

指向流修改说明的指针。

返回代码	说明
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 函数需要管理权限。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	traffic.h
Library	Traffic.lib
DLL	Traffic.dll