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