FwxListenEvent structure

  • Article

Applies to: desktop apps only

The FwxListenEvent structure contains parameters for an event of the fwx_Listen type.

This is the result of the Firewall client calling the listen function, or an application filter calling the IFWXSession::BindForClient method.

Syntax

typedef struct {
  LPSOCKADDR     Address;
  DWORD          AddressLength;
  IFWXConnection *piConnection;
  GUID           ProtocolGuid;
} FwxListenEvent;

Members

  • Address
    Pointer to a sockaddr structure that contains the address the socket was assigned. This is the same as the result of calling the getsockname function on the socket.

  • 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.

  • 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.

Remarks

The filter cannot fail this request because client applications do not expect the listen function to fail. The place for a filter to deny inbound access is in the bind request or when a connection actually arrives. For example, this could occur in an event of the fwx_AcceptedConnection type.

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

 

 

Build date: 7/12/2010