Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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) |