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

Статья
02/07/2025

Структура 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. Чтобы проверить полную историю версий, драйвер выноски должен продолжать изучать предыдущей версии член каждой структуры в списке, пока не будет найден узел, имеющий этот элемент, равный значению NULL.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
заголовка	fwpsk.h (include Fwpsk.h)

См. также

FWPS_FILTER1

FwpsAcquireWritableLayerDataPointer0

FwpsApplyModifiedLayerData0

SOCKADDR_STORAGE

классифицироватьFn

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