wsksockm.cpp

Go to the documentation of this file.

//----------------------------------------------------------------------------
// ObjectWindows
// Copyright (c) 1995, 1996 by Borland International, All Rights Reserved
//
/// \file
/// Winsock for OWL subsystem.
/// Based on work by Paul Pedriana, 70541.3223@compuserve.com
//----------------------------------------------------------------------------
#include <owl/pch.h>
#include <owl/defs.h>
#include <owl/winsock.h>
 
namespace owl {
 
OWL_DIAGINFO;
 
//
/// Default constructor. Initializes all data members to 0.
//
TSocketInfo::TSocketInfo()
{
  wVersion = 0;
  wHighVersion = 0;
  szDescription[0] = 0;
  szSystemStatus[0] = 0;
  iMaxSockets = 0;
  iMaxUdpDg = 0;
  lpVendorInfo = 0;
}
 
//----------------------------------------------------------------------------
 
//
/// The SocketManager constructor takes a major and minor version as parameters.
/// These version parameters are the Winsock versions that can be requested, as with
/// WSAStartup() calls.
//
TSocketManager::TSocketManager(short versionMajor, short versionMinor, bool autoStartup)
{
  TWinSock::IsAvailable();  // !CQ throw an exception if not?
 
  StartupCount = 0;
  Init(versionMajor, versionMinor);
  if (autoStartup)
     Startup();
}
 
//
/// The TSocketManager destructor cleans up after itself. Every time Startup() (same
/// as WSAStartup()) is called, this destructor will call ShutDown (same as
/// WSACleanup()).
//
TSocketManager::~TSocketManager()
{
  while (StartupCount)
    ShutDown();  // Call ShutDown() enough times to equal times Startup() was called.
}
 
//
/// The ITSocketManager function does some initialization for the TSocketManager.
/// This function is separate from the constructor so it can be called at any time
/// to re-specify the desired major and minor versions before a call to Startup().
/// nNewVersionMajor and nNewVersionMinor will be the values specified in the
/// Winsock WSAStartup() call that TSocketManager::Startup() makes. The return value
/// is TRUE or FALSE.
//
void TSocketManager::Init(short versionMajor, short versionMinor)
{
  LastError    = 0;
  VersionMajor = versionMajor;
  VersionMinor = versionMinor;
}
 
//
/// The Startup() function is equivalent to the Winsock WSAStartup() function. This
/// function fills out the TSocketManager's SocketInfo structure (same as a WSAData
/// structure) with the return information. GetMaxSocketsAvailable(),
/// GetVendorInfo(), Available(), GetMajorVersion(), GetMinorVersion(), or
/// Information() functions can then be called to get the results of the call.
//
int TSocketManager::Startup()
{
   uint16 packedValues = (uint16)(((uint16)VersionMinor) << 8) |
                         (uint16)VersionMajor;
   LastError = TWinSockDll::WSAStartup(packedValues, &SocketInfo);
   if (LastError)
     return WINSOCK_ERROR;
 
   StartupCount++;
   VersionMajor = HiUint8(SocketInfo.wVersion);
   VersionMinor = LoUint8(SocketInfo.wVersion);
 
   return WINSOCK_NOERROR;
}
 
//
/// The ShutDown() function is the equivalent to the Winsock WSACleanup() function.
/// You can call this function if you want, but in its destructor, the
/// TSocketManager will automatically call it once for every time Startup() was
/// called. Of course, the TSocketManager cannot know about any independent
/// WSAStartup() direct calls that are made.
//
int TSocketManager::ShutDown()
{
  if (TWinSockDll::WSACleanup()) {
    LastError = TWinSockDll::WSAGetLastError();
    return WINSOCK_ERROR;
  }
  StartupCount--;
  return WINSOCK_NOERROR;
}
 
} // OWL namespace
/* ========================================================================== */