SIO_ADDRESS_LIST_QUERY
L'operazione di controllo I/O socket SIO_ADDRESS_LIST_QUERY consente a un'applicazione WSK di eseguire query sull'elenco corrente degli indirizzi di trasporto locali per la famiglia di indirizzi di un socket. Questa operazione di controllo I/O socket si applica a tutti i tipi di socket.
Per eseguire una query sull'elenco corrente degli indirizzi di trasporto locali per la famiglia di indirizzi di un socket, un'applicazione WSK chiama la funzione WskControlSocket con i parametri seguenti.
| Parametro | Valore |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_ADDRESS_LIST_QUERY |
Level |
0 |
InputSize |
0 |
Inputbuffer |
NULL |
OutputSize |
Dimensioni, in byte, del buffer a cui punta il parametro OutputBuffer . |
OutputBuffer |
Puntatore al buffer che riceve l'elenco corrente di indirizzi di trasporto locali. Le dimensioni del buffer vengono specificate nel parametro OutputSize . |
OutputSizeReturned |
Puntatore a una variabile tipizzata ULONG che riceve il numero di byte di dati copiati nel buffer a cui punta il parametro OutputBuffer . |
Un'applicazione WSK non specifica un puntatore a un'IRP quando si chiama la funzione WskControlSocket per eseguire una query sull'elenco corrente di indirizzi di trasporto locali per la famiglia di indirizzi di un socket.
Se la chiamata alla funzione WskControlSocket ha esito positivo, il buffer di output contiene una struttura SOCKET_ADDRESS_LIST seguita dalle strutture SOCKADDR per ogni indirizzo di trasporto locale per la famiglia di indirizzi del socket.
Se la funzione WskControlSocket restituisce STATUS_BUFFER_OVERFLOW, la variabile a cui punta il parametro OutputSizeReturned contiene le dimensioni del buffer di output, in byte, necessarie per contenere l'elenco completo degli indirizzi di trasporto locali per la famiglia di indirizzi del socket.
L'operazione di controllo I /O socket SIO_ADDRESS_LIST_CHANGE consente a un'applicazione WSK di ricevere una notifica quando è stata apportata una modifica all'elenco degli indirizzi di trasporto locali per la famiglia di indirizzi di un socket.
Requisiti
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Ws2def.h (includere Wsk.h) |