FwxConnectEvent Structure

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

See Also

Structures
FwxFirewallEventParameters
FwxFirewallEventType

Send comments about this topic to Microsoft

Build date: 6/30/2010