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