SIO_ADDRESS_LIST_QUERY

L’opération de contrôle d’E/S de socket SIO_ADDRESS_LIST_QUERY permet à une application WSK d’interroger la liste actuelle des adresses de transport locales pour la famille d’adresses d’un socket. Cette opération de contrôle d’E/S de socket s’applique à tous les types de sockets.

Pour interroger la liste actuelle des adresses de transport locales pour la famille d’adresses d’un socket, une application WSK appelle la fonction WskControlSocket avec les paramètres suivants.

Paramètre	Valeur
RequestType	WskIoctl
ControlCode	SIO_ADDRESS_LIST_QUERY
Niveau	0
InputSize	0
InputBuffer	NULL
OutputSize	Taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre OutputBuffer .
OutputBuffer	Pointeur vers la mémoire tampon qui reçoit la liste actuelle des adresses de transport locales. La taille de la mémoire tampon est spécifiée dans le paramètre OutputSize .
OutputSizeReturned	Pointeur vers une variable de type ULONG qui reçoit le nombre d’octets de données copiées dans la mémoire tampon pointée par le paramètre OutputBuffer .

Une application WSK ne spécifie pas de pointeur vers un IRP lors de l’appel de la fonction WskControlSocket pour interroger la liste actuelle des adresses de transport locales pour la famille d’adresses d’un socket.

Si l’appel à la fonction WskControlSocket réussit, la mémoire tampon de sortie contient une structure SOCKET_ADDRESS_LIST suivie des structures SOCKADDR pour chacune des adresses de transport locales pour la famille d’adresses du socket.

Si la fonction WskControlSocket retourne STATUS_BUFFER_OVERFLOW, la variable vers laquelle pointe le paramètre OutputSizeReturned contient la taille de la mémoire tampon de sortie, en octets, qui doit contenir la liste complète des adresses de transport locales pour la famille d’adresses du socket.

L’opération de contrôle d’E/S de socket SIO_ADDRESS_LIST_CHANGE permet à une application WSK d’être avertie en cas de modification de la liste des adresses de transport locales pour la famille d’adresses d’un socket.

Spécifications

Version	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	Ws2def.h (inclure Wsk.h)