IFWXNetworkSocket interface

Article
08/27/2012

Applies to: desktop apps only

The IFWXNetworkSocket interface is a Microsoft Firewall service socket interface, and is derived from the IFWXSocket interface. The implementation uses the dynamic packet filtering functionality of Forefront TMG to automatically open a packet filter port when necessary, and to close it when the socket is closed.

Note Before releasing this interface, you must call the Close or Shutdown method on it.

Members

The IFWXNetworkSocket interface inherits from IFWXSocket and IUnknown. IFWXNetworkSocket also has these types of members:

Methods

Methods

The IFWXNetworkSocket interface has these methods.

Method	Description
Accept	Asynchronously permits a connection on a listening socket. This method is similar to the Winsock accept function.
Bind	Associates a local address with a socket. This method is similar to the Winsock bind function.
Close	Closes the socket. (Inherited from IFWXSocket)
Connect	Establishes a connection to a specified socket. This method is similar to the Winsock connect function.
GetIpFilter	Gets a copy of the IP filter object for the socket. Returns NULL if the connection is not limited to a range of IP addresses.
GetPeerName	Gets the remote name of a socket. This method is similar to the Winsock getpeername function.
GetSockName	Gets the local name of a socket. This method is similar to the Winsock getsockname function.
GetSockOpt	Gets a socket option. This method is similar to the Winsock getsockopt function.
Listen	Listens on a TCP socket.
Recv	Receives a buffer asynchronously. It performs an overlapped receive (or receive from operation, depending on the socket type). (Inherited from IFWXSocket)
Send	Sends a buffer asynchronously. It performs an overlapped send operation. (Inherited from IFWXSocket)
SendTo	Sends a buffer asynchronously on UDP sockets to a specific address. It performs an overlapped sendto operation. (Inherited from IFWXSocket)
SetIpFilter	Sets the IP filter for the socket. It sets a new IP filter if there was not one, or replaces the current IP filter with a new one.
SetSockOpt	Sets a socket option. This method is similar to the Winsock setsockopt function.
Shutdown	Starts transport shutdown on the socket. (Inherited from IFWXSocket)

Remarks

A socket object that implements this interface can be created by calling IFWXFirewall::CreateNetworkSocket, IFWXSession::CreateNetworkSocket, or IFWXFirewall2::CreateSSLNetworkSocket.

The nature of the socket is determined by which of these three methods is used to create the object. A socket created by calling IFWXFirewall::CreateNetworkSocket is not user-specific. An example of a socket that should not be user-specific is a listening socket. To create a user-specific socket object, use IFWXSession::CreateNetworkSocket. Finally, a socket object created by calling IFWXFirewall2::CreateSSLNetworkSocket represents an SSL socket for secured communication.

An SSL socket does not implement the Accept, Connect, and SendTo methods. For more information, see Socket Implementation in Forefront TMG.

Implementation

This interface is implemented in the Firewall service.

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