FwxUdpDestination structure

Applies to: desktop apps only

The FwxUdpDestination structure contains parameters for an event of the fwx_Udp_Destination type, as defined in the FwxFirewallEventType enumerated type.

An event of this type is triggered in response to the generation of a UDP destination, which occurs under the following circumstances:

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

Syntax

typedef struct _tagFwxUdpDestination {
  LPSOCKADDR            Address;
  DWORD                 AddressLength;
  IFWXConnection        *piConnection;
  IFWXUdpDestination    *piUdpDestination;
  FwxFilterAccess       FilterAccess;
  IFWXPerRuleDataplugin *PerRuleProcessedData;
  GUID                  ProtocolGuid;
  Boolean               IsSecondary;
} FwxUdpDestination;

Members

• Address
  Pointer to a sockaddr structure that contains the address to which the client is attempting to connect.

• AddressLength
  Length, in bytes, of the data pointed to by the Address member.

• piConnection
  Pointer to the IFWXConnection interface on the Microsoft Firewall service connection object for this request.

• piUdpDestination
  Pointer to the IFWXUdpDestination interface that represents the UDP destination generated.

• FilterAccess
  Value from the FwxFilterAccess enumerated type that indicates the type of access permission granted for the event. This member is used internally by the Firewall service and should not be modified or relied upon by application filters.

• PerRuleProcessedData
  Per-rule configuration data for the filter. This data is processed by the Firewall service when it starts, or when the rules are changed.

• ProtocolGuid
  The globally unique identifier (GUID) for the protocol, if known to the Firewall service. If the protocol is not known, this parameter has the value GUID_NULL.

• IsSecondary
  Boolean value that indicates whether the connection is a secondary connection.

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.

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

Requirements

See also

Structures

Build date: 7/12/2010