Compartir a través de


WSK_TRANSPORT_LIST_QUERY

Una aplicación WSK usa la operación de control de cliente WSK_TRANSPORT_LIST_QUERY para recuperar una lista de transportes de red disponibles que se pueden especificar al crear un nuevo socket.

Para recuperar una lista de los transportes de red disponibles, una aplicación WSK llama a la función WskControlClient con los parámetros siguientes.

Parámetro Value

ControlCode

WSK_TRANSPORT_LIST_QUERY

InputSize

0

InputBuffer

NULL

OutputSize

Tamaño, en bytes, de la matriz de estructuras a las que apunta el parámetro OutputBuffer .

OutputBuffer

Puntero a una matriz de estructuras de WSK_TRANSPORT que recibe la lista de transportes de red disponibles.

OutputSizeReturned

Puntero a una variable con tipo SIZE_T que recibe el número de bytes de datos que se copian en la matriz de estructuras a las que apunta el parámetro OutputBuffer .

Irp

NULL

Una aplicación WSK puede especificar cero en el parámetro OutputSize y NULL en el parámetro OutputBuffer para determinar el tamaño de la matriz de estructuras de WSK_TRANSPORT , en bytes, que es necesario para contener la lista completa de transportes de red disponibles. En tal situación, la llamada a la función WskControlClient devuelve STATUS_BUFFER_OVERFLOW y la variable a la que apunta el parámetro OutputSizeReturned contiene el tamaño de búfer necesario. Después, la aplicación puede asignar un búfer lo suficientemente grande como para contener la lista completa de transportes de red disponibles y puede llamar a la función WskControlClient una segunda vez, especificando los parámetros que se muestran en la tabla anterior.

El parámetro Irp debe ser NULL para esta operación de control de cliente.

Requisitos

Versión

Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.

Encabezado

Wsk.h (incluya Wsk.h)