FwxConnectEvent

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.

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

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

Structures, FwxFirewallEventParameters, FwxFirewallEventType