FwxConnectEvent structure

  • Article

Applies to: desktop apps only

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

This information concerns a connect call made by a Firewall client, or a TCP connection initiated by a SecureNAT client.

Syntax

typedef struct _tagFwxConnectEvent {
  LPSOCKADDR            Address;
  DWORD                 AddressLength;
  IFWXConnection        *piConnection;
  FwxFilterAccess       FilterAccess;
  IFWXPerRuleDataplugin *PerRuleProcessedData;
  GUID                  ProtocolGuid;
  BOOL                  IsSecondary;
} FwxConnectEvent;

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.

  • 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
    Pointer to a IFWXPerRuleDataplugin interface that represents the 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

SecureNAT connections will generate an event only if the connection is to a port that is a primary port of a predefined protocol or to an address specified in a call to IFWXSession::AllowFutureConnect. Other connection attempts are dropped by the system before they reach the Firewall service. For more information about NAT and SecureNAT, see secure network address translation.

Requirements

Minimum supported client

 None supported

Minimum supported server

 Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)

Version

 Forefront Threat Management Gateway (TMG) 2010

Header

 Wspfwext.idl

See also

Structures

FwxFirewallEventParameters

FwxFirewallEventType

 

 

Build date: 7/12/2010