Edit

Share via


TcDeregisterClient function (traffic.h)

The TcDeregisterClient function deregisters a client with the Traffic Control Interface (TCI). Before deregistering, a client must delete each installed flow and filter with the TcDeleteFlow and TcDeleteFilter functions, and close all open interfaces with the TcCloseInterface function, respectively.

Syntax

ULONG TcDeregisterClient(
  [in] HANDLE ClientHandle
);

Parameters

[in] ClientHandle

Handle assigned to the client through the previous call to the TcRegisterClient function.

Return value

Return code Description
NO_ERROR
The function executed without errors.
ERROR_INVALID_HANDLE
Invalid interface handle, or the handle was set to NULL.
ERROR_TC_SUPPORTED_OBJECTS_EXIST
Interfaces are still open for this client. all interfaces must be closed to deregister a client.

Remarks

Once a client calls TcDeregisterClient, the only traffic control function the client is allowed to call is TcRegisterClient.

Note  Use of the TcDeregisterClient function requires administrative privilege.
 

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header traffic.h
Library Traffic.lib
DLL Traffic.dll

See also

TcCloseInterface

TcDeleteFilter

TcDeleteFlow

TcRegisterClient