====== atTcpSock ======




===== Plugin information ===

^  Author | [[mailto:aaron@bundysoft.com|Aaron]] |
^  Description | An asynchronous TCP socket communication plugin for L3DT. |
^  Download link | [[http://www.bundysoft.com/L3DT/downloads/plugins/bin/atTcpSock-bin.zip|atTcpSock-bin.zip]] [117kB] |
^  DLL version | v13.05.0.0, 30th of May 2013. |

===== What does it do? =====

The //atTcpSock// provides a wrapper of the Windows WinSock2 asynchronous socket API, and provides the following functionality to plugin developers:
  * Socket creation / destruction.
  * Opening listen sockets, accepting client connections.
  * Connecting sockets.
  * Sending and receiving data asynchronously.
  * Retrieving connection information.
  * Handling Winsock2 callbacks (OnConnect, OnAccept, OnRecv, OnClose, etc.)
  * Retrieving Winsock2 error codes.

===== Using atTcpSock =====

To use the features of //atTcpSock//, we call the extension functions exported by the plugin, the prototypes of which are shown in this snapshot of the extension function explorer plugin:

{{:plugins:network:attcpsock:attcpsock_functions.png|:plugins:network:attcpsock:attcpsock_functions.png}}

To actually use this plugin, it is recommended that you use the 'CzTcpSock' wrapper class, which is included in the source code for the [[plugins:network:zChatClient]] plugin ([[http://www.bundysoft.com/L3DT/downloads/plugins/src/zChatClient-src.zip|C++ source code here]]). This plugin demonstrates how to use all of the socket functions provided by the atTcpSock plugin (via the CzTcpSock class).



===== Changes =====

2013/05/31 --- Released v13.05.0.0, with support for post-2.9 versions of L3DT.

2008/04/28 --- Released v2.5.3.4, with improved send buffer handling.

2008/04/25 --- Released v2.5.3.3, with improved OnRecv callback handling.

2008/03/30 --- Released v2.5.3.0.