FwxUdpDestination

The FwxUdpDestination structure contains parameters for the fwx_Udp_Destination event.

This event is generated when a UDP destination is generated, which occurs under the following circumstances:

• A Firewall client application calls the connect function on a remote UDP socket.
• A firewall client (either SecureNAT or Firewall service) attempts a sendto operation to a new destination.
• A packet has just been sent to the client from the given address.

typedef struct {
  LPSOCKADDR Address;
  DWORD AddressLength;
  IFWXConnection *piConnection;
  IFWXUdpDestination	*piUdpDestination;
  FwxFilterAccess FilterAccess;
} FwxUdpDestination;

Members

Address

[in] Pointer to a sockaddr structure that contains the address to which the client is attempting to connect.

AddressLength

[in] Length, in bytes, of the data pointed to by the Address member.

piConnection

[in] Pointer to the IFWXConnection interface on the Firewall service connection object for this request.

piUdpDestination

[in] Pointer to the IFWXUdpDestination interface.

FilterAccess

[in] Access status for the event. This is a value from the FwxFilterAccess enumerated type. On input, this member indicates the current access status. The filter may not modify this member.

Remarks

The Firewall service keeps a cache of known UDP sources and destinations for each UDP connection object. An event is only generated for destinations that are not in this cache.

The FilterAccess member for the event pertains only to outgoing packets to the destination. The filter may not directly modify this member. To modify the access status, a filter may call IFWXConnection::SetProtocol or IFWXConnection::Deny. Data filters installed by a handler for this event are associated with the destination, and may be detached by the Firewall service when it is invalidating a cached destination.

Although an fwx_Udp_Destination event may be generated as a result of an incoming datagram; it is not intended for interception of inbound traffic. To examine inbound datagrams, use the fwx_Bind_Udp event.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires ISA Server 2000.
  Header: Wspfwext.idl.