FwxListenEvent Structure

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

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

See Also

Structures

Send comments about this topic to Microsoft

Build date: 11/30/2009