структура SOCKET_ADDRESS_LIST (ws2def.h)

Статья
08/28/2023

Структура SOCKET_ADDRESS_LIST определяет список адресов транспорта переменной величины.

Синтаксис

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

Члены

iAddressCount

Количество адресов транспорта в списке.

Address[1]

Массив SOCKET_ADDRESS структур переменной величины. Структура SOCKET_ADDRESS определяется следующим образом:

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

lpSockaddr

Указатель на буфер, содержащий адрес транспорта.

iSockaddrLength

Размер (в байтах) типа структуры SOCKADDR, на который указывает элемент lpSockaddr .

Приложение WSK передает буфер функции WskControlSocket , когда приложение WSK запрашивает текущий список локальных транспортных адресов, соответствующих семейству адресов сокета. Если вызов функции WskControlSocket завершается успешно, буфер содержит структуру SOCKET_ADDRESS_LIST, за которой следуют структуры SOCKADDR для каждого локального адреса транспорта, соответствующего семейству адресов сокета. Подсистема WSK заполняет массив Адресов и задает для элемента iAddressCount количество записей в массиве. Указатели lpSockaddr в каждой из структур SOCKET_ADDRESS массива указывают на конкретный тип структуры SOCKADDR, соответствующий семейству адресов, которое приложение WSK указало при создании сокета.

Дополнительные сведения о запросе текущего списка адресов локального транспорта см. в разделе SIO_ADDRESS_LIST_QUERY.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	ws2def.h (включая Wsk.h)

См. также раздел

SIO_ADDRESS_LIST_QUERY

SOCKADDR

WskControlSocket

Поделиться через