Demonstration of the Windows Sockets API


SUMMARY
=======

The WSOCK sample demonstrates the basics of sockets programming, 
specifically for Windows Sockets. It demonstrates how to accept incoming 
connections (using the Windows Sockets Asynchronous Extension APIs, threads, 
and traditional BSD-style blocking calls) and how to connect to remote 
hosts. Once connected, you can send a text string to the remote host. WSOCK 
also allows the user to view information on a user-entered host name.

WSOCK demonstrates how to use AcceptEx which is a Microsoft specific
extension to Windows Sockets and which is only supported on Windows NT.


MORE INFORMATION
================

For the sample to operate correctly, the TCP/IP protocol must be properly 
installed. Also, if two machines are used over a network, both machines must 
have a HOSTS text file (for Windows NT machines, this file is located in 
%SYSTEMROOT%\SYSTEM32\DRIVERS\ETC\HOSTS; for Windows for Workgroups 
machines, this file is located in C:/WINDOWS/HOSTS). Within each HOSTS file, 
both the remote and local addresses of both machines must be listed.

WSOCK can run on a single machine (execute two copies of WSOCK) or over a 
network with two machines. The following example explains how two separate 
machines over a network would test WSOCK:

 1. Machine "Bob" executes a copy of WSOCK.
 2. Machine "Fred" executes a copy of WSOCK.
 3. Machine "Bob" chooses one of the Listen menu options (under WinSock) 
    [Listen (Blocking), Listen With Threads, or Async Listen].
 4. Machine "Fred" selects the Connect menu option (under WinSock).
 5. Machine "Bob" enters "12" as a TCP port number.
 6. Machine "Bob" waits for a connection.
 7. Machine "Fred" enters "Bob" as the host name to connect to.
 8. Machine "Fred" enters "12" as a TCP port number.

Both machines are now connected and can send strings back and forth by using 
the WinSock Send Message menu option.

If Bob exits WSOCK while there is a connection, Fred receives a message box 
notification.

FUNCTIONS USED
==============

accept
closesocket
connect
gethostbyname
getservbyname
htons
listen
send
recv
WSAAsyncSelect
WSACleanup
WSAStartup