structure SOCKET_ADDRESS_LIST (ws2def.h)

La structure SOCKET_ADDRESS_LIST définit une liste d’adresses de transport de taille variable.

Syntaxe

typedef struct _SOCKET_ADDRESS_LIST {
  INT            iAddressCount;
  SOCKET_ADDRESS Address[1];
} SOCKET_ADDRESS_LIST, *PSOCKET_ADDRESS_LIST, *LPSOCKET_ADDRESS_LIST;

Membres

iAddressCount

Nombre d’adresses de transport dans la liste.

Address[1]

Tableau de tailles variables de structures SOCKET_ADDRESS. La structure SOCKET_ADDRESS est définie comme suit :

typedef struct _SOCKET_ADDRESS {
  LPSOCKADDR  lpSockaddr;
  INT  iSockaddrLength;
} SOCKET_ADDRESS, *PSOCKET_ADDRESS, *LPSOCKET_ADDRESS;

lpSockaddr

Pointeur vers une mémoire tampon qui contient une adresse de transport.

iSockaddrLength

Taille, en octets, du type de structure SOCKADDR vers lequel pointe le membre lpSockaddr .

Remarques

Une application WSK transmet une mémoire tampon à la fonction WskControlSocket lorsque l’application WSK interroge la liste actuelle des adresses de transport locales qui correspondent à la famille d’adresses d’un socket. Si l’appel à la fonction WskControlSocket réussit, la mémoire tampon contient une structure SOCKET_ADDRESS_LIST suivie des structures SOCKADDR pour chacune des adresses de transport locales qui correspondent à la famille d’adresses du socket. Le sous-système WSK remplit le tableau d’adresses et définit le membre iAddressCount sur le nombre d’entrées dans le tableau. Les pointeurs lpSockaddr dans chacune des structures SOCKET_ADDRESS dans le tableau pointent vers le type de structure SOCKADDR spécifique qui correspond à la famille d’adresses spécifiée par l’application WSK lors de la création du socket.

Pour plus d’informations sur l’interrogation de la liste actuelle des adresses de transport locales, consultez SIO_ADDRESS_LIST_QUERY.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	ws2def.h (inclure Wsk.h)

Voir aussi

SIO_ADDRESS_LIST_QUERY

SOCKADDR

WskControlSocket