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

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.

See Also

Structures
FwxFirewallEventParameters
FwxFirewallEventType

Send comments about this topic to Microsoft

Build date: 11/30/2009