通过

TcRegisterClient 函数 (traffic.h)

  • 项目

TcRegisterClient 函数用于向 TCI) (流量控制接口注册客户端。 TcRegisterClient 函数必须是客户端对 TCI 进行的第一个函数调用。

客户端注册提供回调例程，允许 TCI 完成客户端启动的操作或异步事件。 成功注册后， TcRegisterClient 函数的调用方必须准备好调用其任何 TCI 处理程序。 有关详细信息 ，请参阅流量控制接口的客户端公开的入口点 。

语法

ULONG TcRegisterClient(
  [in]  ULONG                 TciVersion,
  [in]  HANDLE                ClRegCtx,
  [in]  PTCI_CLIENT_FUNC_LIST ClientHandlerList,
  [out] PHANDLE               pClientHandle
);

参数

[in] TciVersion

客户端预期的流量控制版本，包括以确保流量控制与客户端之间的兼容性。 客户端可以传递 Traffic.h 中定义的CURRENT_TCI_VERSION。

[in] ClRegCtx

客户端注册上下文。 调用客户端的通知处理程序函数时，将返回 ClRegCtx。 这可以是一个容器，用于保存此接口实例的任意客户端定义的上下文。

[in] ClientHandlerList

指向客户端提供的处理程序列表的指针。 客户端提供的处理程序用于通知事件和异步完成。 每个完成例程都是可选的，通知处理程序除外。 将通知处理程序设置为 NULL 将返回ERROR_INVALID_PARAMETER。

[out] pClientHandle

指向流量控制用于将注册句柄返回给客户端的缓冲区的指针。

返回值

返回代码 说明
NO_ERROR
 执行函数时未出错。
ERROR_NOT_ENOUGH_MEMORY
 系统内存不足。
ERROR_INVALID_PARAMETER
 其中一个参数为 NULL。
ERROR_INCOMPATIBLE_TCI_VERSION
 TCI 版本错误。
ERROR_OPEN_FAILED
 流量控制无法打开系统设备。 可能的原因是权限不足。
ERROR_TOO_MANY_CLIENTS
 流量控制无法注册到内核组件 GPC。 可能的原因是当前连接的流量控制客户端过多。

Windows 2000： 不支持此值。

注解

某些返回代码可在 tcerror.h 中找到。

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

要求

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