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) |