通过

tcQueryFlowW 函数 (traffic.h)

  • 项目

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

语法

ULONG TcQueryFlowW(
  [in]      LPWSTR 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 [仅限桌面应用]
目标平台 Windows
标头 traffic.h
DLL Traffic.dll

另请参阅

GUID

TcEnumerateFlows

TcGetFlowName