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 funzioneWskControlClientcon i parametri seguenti.

Parametro	Valore
ControlCode	WSK_TRANSPORT_LIST_QUERY
InputSize	0
InputBuffer	NULL
OutputSize	Dimensione, in byte, della matrice di strutture a cui punta il parametro OutputBuffer
OutputBuffer	Puntatore a una matrice di strutture WSK_TRANSPORT che riceve l'elenco dei trasporti di rete disponibili
OutputSizeReturned	Puntatore a una variabile tipizzata SIZE_T 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 una situazione di questo tipo, la chiamata alla funzioneWskControlClientrestituisce 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 di dimensioni sufficienti 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.

Fabbisogno

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