SIO_ADDRESS_LIST_QUERY

L'operazione di controllo I/O socket SIO_ADDRESS_LIST_QUERY consente a un'applicazione WSK di eseguire una query sull'elenco corrente di indirizzi di trasporto locali per la famiglia di indirizzi di un socket. Questa operazione di controllo di I/O socket si applica a tutti i tipi di socket.

Per eseguire una query sull'elenco corrente di indirizzi di trasporto locali per la famiglia di indirizzi di un socket, un'applicazione WSK chiama la funzioneWskControlSocketcon i parametri seguenti.

Parametro	Valore
RequestType	WskIoctl
ControlCode	SIO_ADDRESS_LIST_QUERY
livello	0
InputSize	0
InputBuffer	NULLO
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 di indirizzi di trasporto locali per la famiglia di indirizzi di un socket.

Fabbisogno

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