Export (0) Print
Expand All

FWPS_BIND_REQUEST0 structure

The FWPS_BIND_REQUEST0 structure defines modifiable data for the FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 and FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6 layers. The callout driver uses this data to inspect or modify the connection information.

Note  FWPS_BIND_REQUEST0 is a specific version of FWPS_BIND_REQUEST. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Syntax


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

Members

localAddressAndPort

The local transport address of the bind request. This is an IPV4 or IPV6 address and TCP/UDP port formatted as a SOCKADDR_STORAGE structure.

portReservationToken

A token used to reserve the appropriate port. The token is obtained when a port is reserved by calling either CreatePersistentTcpPortReservation or CreatePersistentUdpPortReservation. Both reservation functions can be found in iphlpapi.h.

previousVersion

The previous version of the bind request data. This read-only field records the modification history of the bind request. This member is preinitialized with a pointer to a singly linked list with the index set to the record for the current FWPS_BIND_REQUEST0 data.

modifierFilterId

The value of the FilterId member of the classifyFn function's filter parameter. For more information about the FilterId member, see FWPS_FILTER1.

Remarks

The callout driver obtains this structure by calling the FwpsAcquireWritableLayerDataPointer0 function, which returns a pointer to a FWPS_BIND_REQUEST0 structure through the writableLayerData parameter.

The classifyFn function can modify the bind request's parameters, such as redirecting the local transport address or port to another address or port. If it modifies the bind request's parameters, the classifyFn function must do the following:

This structure acts as a linked list that contains a record of all changes made by other callout drivers. There is previous version information if the previousVersion member is not NULL. To examine the complete version history, the callout driver must continue to examine the previousVersion member of each structure in the list until it is finds a node that has this member set to a value of NULL.

Requirements

Version

Available starting with Windows 7.

Header

Fwpsk.h (include Fwpsk.h)

See also

classifyFn
FWPS_FILTER1
FwpsApplyModifiedLayerData0
FwpsAcquireWritableLayerDataPointer0
SOCKADDR_STORAGE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft