CSocket

CSocket();

Operations

virtual void Accept(CSocket& rClientSock, struct sockaddr* addr, int* addrlen);

virtual int Bind(LPCTSTR addr, UINT port);

virtual int Bind(const struct sockaddr* name, int namelen);

virtual int Connect(LPCTSTR addr, UINT port);

virtual int Connect(const struct sockaddr* name, int namelen);

virtual bool Create( int family, int type, int protocol = IPPROTO_IP);

virtual void Disconnect();

virtual void FreeAddrInfo( struct addrinfo* ai );

virtual int GetAddrInfo( LPCTSTR nodename, LPCTSTR servname, const struct addrinfo* hints, struct addrinfo** res);

virtual int ioCtlSocket(long cmd, u_long* argp);

virtual int Listen(int backlog = SOMAXCONN);

virtual int Receive(char* buf, int len, int flags);

ReceiveFrom(char* buf, int len, int flags, struct sockaddr* from, int* fromlen);

virtual int Send(LPCTSTR buf, int len, int flags);

virtual int SendTo(const char* send, int len, int flags, LPCTSTR addr, UINT port);

virtual int SendTo(const char* buf, int len, int flags, const struct sockaddr* to, int tolen);

virtual void StartEvents();

virtual void StopEvents();

Attributes

virtual LPCTSTR GetLastError();

virtual int GetPeerName(struct sockaddr* name, int* namelen);

SOCKET& GetSocket();

virtual int GetSockName(struct sockaddr* name, int* namelen);

virtual int GetSockOpt(int level, int optname, char* optval, int* optlen);

virtual bool IsIPV6Supported();

virtual int SetSockOpt(int level, int optname, const char* optval, int optlen);

Overridables

virtual void OnAccept();

virtual void OnAddresListChange();

virtual void OnDisconnect();

virtual void OnConnect();

virtual void OnOutOfBand();

virtual void OnQualityOfService();

virtual void OnReceive();

virtual void OnRoutingChange();

virtual void OnSend();

Remarks

CSocket's constructor will throw a CWinException if WSAStartup fails or if the WS2_32.dll DLL fails to load. You can catch this exception if you wish to handle this rather unlikely situation gracefully. Note that windows 95 may not have WS2_32.dll.

IP version 6 support

IP version 6 is not supported on all operating systems or all development environments. Keep the following in mind when offering support for IP version 6 in your applications.

• IPv6 is supported on Windows Vista and above. Windows XP with SP2 provides "experimental" support, which can be enabled by entering "ipv6 install" at a command prompt.
• IPv6 is not supported by all compilers and development environments. In particular, it is not supported by Dev-C++ or Borland 5.5. A modern Platform SDK needs to be added to Visual Studio 6 for it to support IPv6.
• The IsIPV6Supported function returns false if either the operating system or the development environment fails to support IPv6.

Network client code

The following code segments are complete programs which demonstrate how to write a simple network client and server.

#include 
#include 
#include "winsock2.h"
#include "../../Win32++/socket.h"

using namespace std;
using namespace Win32xx;


class CClientSocket : public CSocket
{
public:
  CClientSocket() {}
  virtual void OnReceive()
  {
    // This function is called automatically when there is data to receive
    TCHAR str[1024] = {0};
    int i = Receive(str, 1024, 0);

    cout << i << " chars received: " << str << endl;
  }
};

int main()
{
  CClientSocket Client;

  // Create the socket to communicate with the Server
  if (!Client.Create(SOCK_STREAM))
  {
    cout << "Failed to create socket\n" ;
    return 0;
  }

  // Connect to the server
  if (SOCKET_ERROR == Client.Connect(_T("127.0.0.1", 3000)))
  {
    cout << "Failed to connect to server. Was it running?\n";
    return 0;
  }
  cout << "Connected to server.\n";
  cout << "Type data to send, type quit to exit\n";

  // Monitor the client socket for network events, such as data ready to receive
  Client.StartEvents();

  // Send data to the server
  string s;
  for (;;)	// Infinite loop
  {
    getline(cin, s);
    if (s == "quit") break;
    int i = Client.Send(s.c_str(), (int)s.length(), 0);
    cout << "Sending  " << i << " characters\n";
  }

  return 0;
}

Network server code

#include 
#include 
#include "winsock2.h"
#include "../../Win32++/socket.h"

using namespace std;
using namespace Win32xx;


class CServerSocket : public CSocket
{
public:
  CServerSocket() {}
  virtual ~CServerSocket() {}
  virtual void OnReceive()
  {
    // This function is called automatically when there is data to receive
    TCHAR str[1024] = {0};
    int i = Receive(str, 1024, 0);
    cout << i <<" chars received: " << str << endl;
  }
};

int main()
{
  // Create the main server socket.
  // It is used to listen for clients
  CServerSocket Server;
  if (!Server.Create(SOCK_STREAM))
  {
    cout << "Failed to create socket\n" ;
    return 0;
  }

  // Bind the IP address and port# to the main socket
  if (SOCKET_ERROR == Server.Bind(_T("127.0.0.1", 3000)))
  {
    cout << "Failed to bind IP address to socket\n" ;
    return 0;
  }

  // Listen on the socket for clients to connect
  if (SOCKET_ERROR == Server.Listen())
  {
    cout << "Listen on socket failed\n";
    return 0;
  }

  // Create the socket to communicate with the Client
  CServerSocket Client;
  cout << "Waiting for the client to connect\n";
  do
  {
    Server.Accept(Client, NULL, NULL);
  }
  while (SOCKET_ERROR == Client.GetSocket());

  cout << "Client connected\n";

  // Monitor the client socket for network events, such as data ready to receive
  Client.StartEvents();

  // Send data to the client
  cout << "Type data to send, type quit to exit\n";
  string s;
  for (;;)   // infinite loop
  {
    getline(cin, s);
    if (s == "quit") break;
    int i = Client.Send(s.c_str(), (int)s.length(), 0);
    cout << "Sending  " << i << " characters\n";
  }

  return 0;
}

Refer to the Networking ClientDlg and ServerDlg sample for a more comprehensive demonstration of the features of CSocket.

Summary Information