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) |