Platform SDK: Quality of Service

TcSetInterface

The TcSetInterface function sets individual parameters for a given interface.

DWORD TcSetInterface(
  HANDLE IfcHandle,
  PGUID pGuidParam,
  ULONG BufferSize,
  PVOID Buffer 
);

Parameters

IfcHandle
[in] Handle associated with the interface to be set. This handle is obtained by a previous call to the TcOpenInterface function.
pGuidParam
[in] 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.
BufferSize
[in] Size of the client-provided buffer.
Buffer
[in] Pointer to a client-provided buffer. Buffer must contain the value to which the traffic control parameter provided in pGuidParam should be set.

Return Values

Error codes 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.

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Traffic.h.
  Library: Use Traffic.lib.