TcQueryFlowA 函数 (traffic.h)

TcQueryFlow 函数根据流名称查询特定流参数的值的流量控制。 可以从 TcEnumerateFlows 函数或 TcGetFlowName 函数检索流的名称。

语法

ULONG TcQueryFlowA(
  [in]      LPSTR  pFlowName,
  [in]      LPGUID pGuidParam,
  [in, out] PULONG pBufferSize,
  [out]     PVOID  Buffer
);

参数

[in] pFlowName

要查询的流的名称。

[in] pGuidParam

指向对应于相关流参数的全局唯一标识符(GUID)的指针。 可以在 GUID中找到流量控制 GUID 的列表。

[in, out] pBufferSize

指向客户端提供的缓冲区的大小或流量控制使用的字节数的指针。 对于输入,请指向 缓冲区的大小(以字节为单位)。 对于输出,请指向使用返回的流参数数据写入的实际缓冲区空间量(以字节为单位)。

[out] Buffer

指向在其中写入返回的流参数的客户端提供的缓冲区的指针。

返回值

返回代码 描述
NO_ERROR
未出错执行的函数。
ERROR_INVALID_PARAMETER
参数无效。
ERROR_INSUFFICIENT_BUFFER
提供的缓冲区太小,无法保存结果。
ERROR_NOT_SUPPORTED
不支持请求的 GUID。
ERROR_WMI_GUID_NOT_FOUND
设备未注册此 GUID。
ERROR_WMI_INSTANCE_NOT_FOUND
找不到实例名称,可能是因为流或接口正在关闭。

言论

使用 TcQueryFlow 函数需要管理权限。

注意

traffic.h 标头将 TcQueryFlow 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

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

另请参阅

GUID

TcEnumerateFlows

TcGetFlowName