| Microsoft Internet Security and Acceleration Server 2004 SDK |
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 ISA Server 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.
The IFWXNetworkSocket interface inherits the methods of the standard COM interface IUnknown.
In addition, IFWXNetworkSocket defines the following methods, including those inherited from IFWXSocket.
| Method | Description |
|---|---|
| Send | Sends a buffer asynchronously. It performs an overlapped send operation. |
| SendTo | Sends a buffer asynchronously on UDP sockets to a specific address. It performs an overlapped sendto operation. |
| Recv | Receives a buffer asynchronously. It performs an overlapped receive (or receive from operation, depending on the socket type). |
| Shutdown | Starts transport shutdown on the socket. |
| Close | Closes the socket. |
| Connect | Establishes a connection to a specified socket. This method is similar to the Winsock connect function. |
| Bind | Associates a local address with a socket. This method is similar to the Winsock bind function. |
| GetSockName | Gets the local name of a socket. This method is similar to the Winsock getsockname function. |
| GetPeerName | Gets the remote name of a socket. This method is similar to the Winsock getpeername function. |
| Listen | Listens on a TCP socket. |
| SetSockOpt | Sets a socket option. This method is similar to the Winsock setsockopt function. |
| GetSockOpt | Gets a socket option. This method is similar to the Winsock getsockopt function. |
| Accept | Asynchronously permits a connection on a listening socket. This method is similar to the Winsock accept function. |
| 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. |
| 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. |
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 ISA Server.
This interface is implemented in the Firewall service.
Server: Requires Windows Server 2003 or
Windows 2000.
Version: Requires Internet Security and Acceleration
Server 2004.
Header: Declared in Wspfwext.idl.