TcGetFlowNameW function (traffic.h)

The TcGetFlowName function provides the name of a flow that has been created by the calling client. Flow properties and other characteristics of flows are provided based on the name of a flow. Flow names can also be retrieved by a call to the TcEnumerateFlows function.

Syntax

ULONG TcGetFlowNameW(
  HANDLE FlowHandle,
  ULONG  StrSize,
  LPWSTR pFlowName
);

Parameters

FlowHandle

Handle for the flow.

StrSize

Size of the string buffer provided in pFlowName.

pFlowName

Pointer to the output buffer holding the flow name.

Return value

Return code Description
NO_ERROR
The function executed without errors.
ERROR_INVALID_HANDLE
The flow handle is invalid.
ERROR_INVALID_PARAMETER
One of the parameters is invalid.
ERROR_INSUFFICIENT_BUFFER
The buffer is too small to contain the results.

Remarks

Use of the TcGetFlowName function requires administrative privilege.

Note

The traffic.h header defines TcGetFlowName as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

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

See also

TcEnumerateFlows