структура FWPS_BIND_REQUEST0 (fwpsk.h)

  • Статья

Структура FWPS_BIND_REQUEST0 определяет изменяемые данные для слоев FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 и FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. Драйвер выноски использует эти данные для проверки или изменения сведений о подключении.

ПримечаниеFWPS_BIND_REQUEST0 — это определенная версия FWPS_BIND_REQUEST. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .
 

Синтаксис

typedef struct _FWPS_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

Члены

localAddressAndPort

Локальный транспортный адрес запроса привязки. Это адрес IPV4 или IPV6 и порт TCP/UDP, отформатированный в виде SOCKADDR_STORAGE структуры.

portReservationToken

Маркер, используемый для резервирования соответствующего порта. Маркер получается при резервации порта путем вызова метода CreatePersistentTcpPortReservation или CreatePersistentUdpPortReservation. Обе функции резервирования можно найти в iphlpapi.h.

previousVersion

Предыдущая версия данных запроса привязки. Это поле, доступное только для чтения, записывает журнал изменений запроса привязки. Этот элемент предварительно инициализирован с помощью указателя на отдельно связанный список с индексом, заданным для записи для текущих данных FWPS_BIND_REQUEST0.

modifierFilterId

Значение элемента FilterId параметра фильтра функции classifyFn. Дополнительные сведения об элементе FilterId см. в разделе FWPS_FILTER1.

Комментарии

Драйвер выноски получает эту структуру путем вызоваФункция FwpsAcquireWritableLayerDataPointer0, которая возвращает указатель на структуру FWPS_BIND_REQUEST0 с помощью параметра writableLayerData.

Функция classifyFn может изменять параметры запроса на привязку, например перенаправлять локальный транспортный адрес или порт на другой адрес или порт. Если он изменяет параметры запроса привязки, то
Функция classifyFn должна выполнять следующие действия:

  • Внесите все изменения в структуру FWPS_BIND_REQUEST0 , возвращенную FwpsAcquireWritableLayerDataPointer0. Изменять можно только члены localAddressAndPort и portReservationToken .
  • Вызов FwpsApplyModifiedLayerData0 с параметром modifiedLayerData , заданным для адреса структуры FWPS_BIND_REQUEST0 , даже если драйвер выноски не изменил никаких данных. Это значение должно совпадать со значением параметра modifiedLayerData , возвращенным FwpsAcquireWritableLayerDataPointer0.
Эта структура выступает в качестве связанного списка, содержащего запись обо всех изменениях, внесенных другими драйверами выносок. Сведения о предыдущей версии имеются, если член previousVersion не имеет значения NULL. Чтобы изучить полный журнал версий, драйвер выноски должен продолжать изучать элемент previousVersion каждой структуры в списке, пока не найдет узел, для которого этому члену присвоено значение NULL.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 7.
Верхняя часть fwpsk.h (включая Fwpsk.h)

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

FWPS_FILTER1

FwpsAcquireWritableLayerDataPointer0

FwpsApplyModifiedLayerData0

SOCKADDR_STORAGE

classifyFn