WSK_TRANSPORT_LIST_QUERY

Un'applicazione WSK usa l'operazione di controllo client WSK_TRANSPORT_LIST_QUERY per recuperare un elenco di trasporti di rete disponibili che possono essere specificati durante la creazione di un nuovo socket.

Per recuperare un elenco dei trasporti di rete disponibili, un'applicazione WSK chiama la funzione WskControlClient con i parametri seguenti.

Parametro	Valore
ControlCode	WSK_TRANSPORT_LIST_QUERY
InputSize	0
Inputbuffer	NULL
OutputSize	Dimensioni, in byte, della matrice di strutture a cui punta il parametro OutputBuffer
OutputBuffer	Puntatore a una matrice di strutture di WSK_TRANSPORT che riceve l'elenco dei trasporti di rete disponibili
OutputSizeReturned	Puntatore a una variabile SIZE_T tipizzata che riceve il numero di byte di dati copiati nella matrice di strutture a cui punta il parametro OutputBuffer
Irp	NULL

Un'applicazione WSK può specificare zero nel parametro OutputSize e NULL nel parametro OutputBuffer per determinare le dimensioni della matrice di strutture WSK_TRANSPORT, in byte, necessarie per contenere l'elenco completo dei trasporti di rete disponibili. In tale situazione, la chiamata alla funzione WskControlClient restituisce STATUS_BUFFER_OVERFLOW e la variabile a cui punta il parametro OutputSizeReturned contiene le dimensioni del buffer necessarie. L'applicazione può quindi allocare un buffer sufficiente per contenere l'elenco completo dei trasporti di rete disponibili e può chiamare la funzione WskControlClient una seconda volta, specificando i parametri visualizzati nella tabella precedente.

Il parametro Irp deve essere NULL per questa operazione di controllo client.

Requisiti

Versione	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	Wsk.h (include Wsk.h)