通过

TcQueryInterface 函数 (traffic.h)

  • 项目

TcQueryInterface 函数查询相关的每个接口参数的流量控制。 通过 (GUID) 提供其全局唯一标识符来查询流量控制参数。 将 NotifyChange 参数设置为 TRUE 可在指定的 GUID 上启用事件通知，之后每当查询的参数发生更改时，通知事件将发送到客户端。 客户端可以请求通知的 GUID 位于 GUID 条目中;标题为“通知”的列表示哪些 GUID 可用于通知。

语法

ULONG TcQueryInterface(
  [in]      HANDLE  IfcHandle,
  [in]      LPGUID  pGuidParam,
  [in]      BOOLEAN NotifyChange,
  [in, out] PULONG  pBufferSize,
  [out]     PVOID   Buffer
);

参数

[in] IfcHandle

与要查询的接口关联的句柄。 此句柄是通过以前对 TcOpenInterface 函数的调用获取的。

[in] pGuidParam

指向与所查询的流量控制参数相对应的全局唯一标识符 (GUID) 的指针。

[in] NotifyChange

用于从流量控制请求要查询的参数的通知。 如果为 TRUE，则流量控制将在更改与 pGuidParam 中提供的 GUID 对应的参数时，通过 ClNotifyHandler 函数通知客户端。 默认情况下，通知处于关闭状态。

[in, out] pBufferSize

指示缓冲区的大小（以字节为单位）。 对于输入，此值是调用方分配的缓冲区的大小。 对于输出，此值是流量控制所使用的缓冲区的实际大小（以字节为单位）。

[out] Buffer

指向客户端分配的缓冲区的指针，返回的数据将写入其中。

返回值

请注意，对于请求的通知状态，只有返回值 NO_ERROR 将导致应用请求的通知状态。 如果从 对 TcQueryInterface 函数的调用返回除 NO_ERROR 以外的返回值，则不会接受请求的通知状态更改。

返回代码 说明
NO_ERROR
 执行函数时未出错。
ERROR_INVALID_HANDLE
 接口句柄无效。
ERROR_INVALID_PARAMETER
 无效或 NULL 参数。
ERROR_INSUFFICIENT_BUFFER
 缓冲区太小，无法存储结果。
ERROR_NOT_SUPPORTED
 提供的接口不支持查询提供的 GUID。
ERROR_WMI_GUID_NOT_FOUND
 设备未注册此 GUID。
ERROR_WMI_INSTANCE_NOT_FOUND
 找不到实例名称，可能是因为接口正在关闭。

注解

注意 使用 TcQueryInterface 函数需要管理权限。
 

要求

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

另请参阅

ClNotifyHandler

TcEnumerateInterfaces

TcRegisterClient