Partager via


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

ZÉRO

OutputSize

Taille, en octets, de la mémoire tampon pointée par 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 typée 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 de la famille d’adresses du socket.

Si la fonction WskControlSocket retourne STATUS_BUFFER_OVERFLOW, la variable pointée par le paramètre OutputSizeReturned contient la taille de mémoire tampon de sortie, en octets, nécessaire pour 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 lorsqu’une modification a été apportée à la liste des adresses de transport locales pour la famille d’adresses d’un socket.

Exigences

Version

Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.

En-tête

Ws2def.h (include Wsk.h)