SIO_ADDRESS_LIST_QUERY

Операция управления SIO_ADDRESS_LIST_QUERY сокета позволяет приложению WSK запрашивать текущий список локальных транспортных адресов для семейства адресов сокета. Эта операция управления вводом-выводом сокета применяется ко всем типам сокетов.

Чтобы запросить текущий список локальных транспортных адресов для семейства адресов сокета, приложение WSK вызывает функцию WskControlSocket со следующими параметрами.

Параметр Значение

RequestType

WskIoctl

ControlCode

SIO_ADDRESS_LIST_QUERY

Уровень

0

Размер входных данных

0

InputBuffer

NULL

OutputSize

Размер (в байтах) буфера, на который указывает параметр OutputBuffer .

OutputBuffer

Указатель на буфер, который получает текущий список адресов локального транспорта. Размер буфера указывается в параметре OutputSize .

OutputSizeReturned

Указатель на переменную типа ULONG, которая получает количество байтов данных, копируемых в буфер, на который указывает параметр OutputBuffer .

Приложение WSK не указывает указатель на IRP при вызове функции WskControlSocket для запроса текущего списка локальных транспортных адресов для семейства адресов сокета.

Если вызов функции WskControlSocket завершается успешно, выходной буфер содержит структуру SOCKET_ADDRESS_LIST , за которой следуют структуры SOCKADDR для каждого локального адреса транспорта семейства адресов сокета.

Если функция WskControlSocket возвращает STATUS_BUFFER_OVERFLOW, переменная, на которую указывает параметр OutputSizeReturned , содержит размер выходного буфера в байтах, необходимый для хранения полного списка локальных транспортных адресов для семейства адресов сокета.

Операция управления SIO_ADDRESS_LIST_CHANGE сокета позволяет приложению WSK получать уведомления об изменении списка локальных транспортных адресов для семейства адресов сокета.

Требования

Версия

Доступно в Windows Vista и более поздних версиях операционных систем Windows.

Заголовок

Ws2def.h (включая Wsk.h)