TcSetInterface function (traffic.h)

The TcSetInterface function sets individual parameters for a given interface.

Syntax

ULONG TcSetInterface(
  [in] HANDLE IfcHandle,
  [in] LPGUID pGuidParam,
  [in] ULONG  BufferSize,
  [in] PVOID  Buffer
);

Parameters

[in] IfcHandle

Handle associated with the interface to be set. This handle is obtained by a previous call to the TcOpenInterface function.

[in] pGuidParam

Pointer to the globally unique identifier (GUID) that corresponds to the parameter to be set. A list of available GUIDs can be found in GUID.

[in] BufferSize

Size of the client-provided buffer, in bytes.

[in] Buffer

Pointer to a client-provided buffer. Buffer must contain the value to which the traffic control parameter provided in pGuidParam should be set.

Return value

Return code Description
NO_ERROR
The function executed without errors.
ERROR_INVALID_HANDLE
Invalid interface handle.
ERROR_INVALID_PARAMETER
Invalid parameter.
ERROR_NOT_SUPPORTED
Setting the GUID for the provided interface is not supported.
ERROR_WMI_INSTANCE_NOT_FOUND
The GUID is not available.
ERROR_WMI_GUID_NOT_FOUND
The device did not register for this GUID.

Remarks

Note  Use of the TcSetInterface function requires administrative privilege. The list of GUIDs that can be set is explained in GUID.
 

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

GUID

TcOpenInterface