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


WSK_TRANSPORT_LIST_QUERY

Приложение WSK использует операцию управления WSK_TRANSPORT_LIST_QUERY клиента для получения списка доступных сетевых транспортов, которые можно указать при создании нового сокета.

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

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

ControlCode

WSK_TRANSPORT_LIST_QUERY

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

0

InputBuffer

NULL

OutputSize

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

OutputBuffer

Указатель на массив WSK_TRANSPORT структур, получающий список доступных сетевых транспортных средств.

OutputSizeReturned

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

Irp

NULL

Приложение WSK может указать ноль в параметре OutputSize и NULL в параметре OutputBuffer , чтобы определить размер массива WSK_TRANSPORT структур в байтах, необходимый для хранения полного списка доступных сетевых транспортов. В такой ситуации вызов функции WskControlClient возвращает STATUS_BUFFER_OVERFLOW, а переменная, на которую указывает параметр OutputSizeReturned , содержит требуемый размер буфера. Затем приложение может выделить буфер, который достаточно велик, чтобы содержать полный список доступных сетевых транспортов, и может вызвать функцию WskControlClient во второй раз, указав параметры, показанные в предыдущей таблице.

Параметр Irp должен иметь значение NULL для этой операции клиентского управления.

Требования

Версия

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

Заголовок

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