FwxListenEvent structure

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.


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


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


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.


Minimum supported client

None supported

Minimum supported server

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


Forefront Threat Management Gateway (TMG) 2010



See also




Build date: 7/12/2010