WSK_TRANSPORT_LIST_QUERY

A WSK application uses the WSK_TRANSPORT_LIST_QUERY client control operation to retrieve a list of available network transports that can be specified when creating a new socket.

To retrieve a list of available network transports, a WSK application calls the WskControlClient function with the following parameters.

Parameter Value

ControlCode

WSK_TRANSPORT_LIST_QUERY

InputSize

0

InputBuffer

NULL

OutputSize

The size, in bytes, of the array of structures that is pointed to by the OutputBuffer parameter

OutputBuffer

A pointer to an array of WSK_TRANSPORT structures that receives the list of available network transports

OutputSizeReturned

A pointer to a SIZE_T-typed variable that receives the number of bytes of data that are copied into the array of structures that is pointed to by the OutputBuffer parameter

Irp

NULL

A WSK application can specify zero in the OutputSize parameter and NULL in the OutputBuffer parameter to determine the size of the array of WSK_TRANSPORT structures, in bytes, that is required to contain the complete list of available network transports. In such a situation, the call to the WskControlClient function returns STATUS_BUFFER_OVERFLOW, and the variable that is pointed to by the OutputSizeReturned parameter contains the required buffer size. The application can then allocate a buffer that is large enough to contain the complete list of available network transports and can call the WskControlClient function a second time, specifying the parameters that are shown in the preceding table.

The Irp parameter must be NULL for this client control operation.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Wsk.h (include Wsk.h)