CRasMonitor v1.41

Welcome to CRasMonitor v1.41, A freeware MFC class to monitor RAS (aka Dial-Up Networking) connections.

Features

• Simple and clean C++ interface.
• The code works on both Windows 95/98 and NT. The RAS API itself is very OS dependent with some of its functions only available on Windows NT.
• The code has been designed in such a way that it has a minimum impact on the performance of the OS.
• The classes are fully Unicode compliant.

Usage

• To use the class in your code simply include rasmonitor.cpp in your project and #include rasmonitor.h in which ever of your modules needs to make calls to the class. As of v1.4 the code depends on 2 additional modules of the author. These are the DynData which encapsulate the Windows 95/98 performance counters and CPdh which encapsulates the NT Performance Counters. You will need to download both of these modules from the Authors web site to use the CRasMonitor class. Also ensure that these modules have been added to your project.
• Your code will need to include MFC either statically or dynamically.
• You will also need to have afxtempl.h ,winsock.h or afxsock.h, afxpriv.h and winsvc.h in your precompiled header. The code will work just aswell in a GUI or console app. The code should also work in a multithreaded application, although it has not be explicitly tested in this scenario.
• CRasMonitor requires that the latest version of Winsock and Dial-Up Networking are installed on client machines.  Even if you are running the latest version of Windows 95 (Win95 B aka OSR2), you will still need to download and install this update.  Windows 98 includes the latest versions, so no additional downloads are required.
   
  The easiest way to determine if you have the correct version of Dial-Up Networking installed is to check the icon that is added to your system tray (next to the clock) when you establish a connection to your Internet Service Provider (ISP), as shown below:

  or	You need to download the updates
  	You already have Dial-Up Networking v1.3 or above installed.

  
  The updated versions are available from the Microsoft Web site.  At the time or writing, you can get the update by clicking here.  If that page has moved (which it has in the past), you can find the update by following these steps:

  Go to the Microsoft site (http://www.microsoft.com).
  Follow the links to Products, Windows, Windows 95, System updates.
  Download the Dial-Up Networking v1.3 update

  For NT users you need to ensure that you have the PSAPI.DLL installed into your system32 directory on NT. If this file is not already present on your machine, then you can download it from http://indigo.ie/~pjn/download/psapi.dll.

History

V1.0 (5 July 1998)

• Initial public release.

26 July 1998

• RasMan sample application had been updated. See the rasman.htm file for further details.

v1.1 (1 October 1998)

• Updated code to include a virtual OnDial method
• Optimized the code by using CArray::ElementAt
• Added the following member variables to CRasConnection: Dial Time, whether or not the connection is currently connected, Dial Duration and the RAS handle
• Renamed the connection variable of CRasConnection
• Updated the sample program to v1.1
• Updated the version info in the sample app to include the build date
• Fixed a problem when enumerating more than one RAS connection at a time.
• Sample app now uses LoadImage instead of LoadIcon to avoid the shell first scaling up to 32*32 and then back to 16*16.
• What this means is that the icons RasMan puts in the tray notification area will not look blurred.
• Fixed a memory leak in CRasMonitor::DoCheck() when multiple connections were being enumerated.
• Included a new selection of tray icons in the sample app.
• Updated the documentation to reflect the name changes and the new member variables and methods
• Added a popup menu item to bring up the help file.

v1.2 (6 November 1998)

• Major optimisation added to reduce memory usage (c. 3 MB) on NT when RAS service is not running. Thanks to Daniel Harth for this very neat optimisation.
• Internally the code now uses a hidden window to perform the monitoring instead of a worker thread. This helps avoid potential deadlock problems which can occur as previously the code used a worker thread.
• Now uses window messages instead of virtual functions to implement class customisation

17 November 1998

• Removed sample app as RasMan application is now shareware. All that is now included is the source code, header file and associated documentation.

v1.21 (2 February 1999)

• Fixed a compile problem which was occurring when code was compiled for UNICODE.
• Fixed a crash which was occuring when the code was run on NT and you do not have RAS installed.
• When running on NT, the code now only uses SC_MANAGER_ENUMERATE_SERVICE privileges when connecting to the Service Configuration Manager.
• CRasConnection connection now includes a standard MFC Serialize method.
• CRasMonitor now has a standard MFC Serialize method. This can be incorporated into an app to prevent RAS events being lost if the application or OS were to crash. This is used in the authors RasMan application to ensure no RAS records were lost even if the machine crashed while any RAS connection was in progress.

v1.4 (21 February 1999)

• Synced version number up to the same version as RasMan application.
• Now reports the following additional statistics: Connection speed (Bytes / Second) (on Windows 95, 98 only), Bytes sent (Windows 95, 98 & NT) and Bytes received (Windows 95, 98 & NT)
• Update the usage instructions about what is required on client machines.

v1.41 (25 January 2000)

• Removed a memory leak which was occurring on NT where the CPdhCounter instances in the GetInitialConnectionDetails and GetCurrentConnectionDetails functions were not being tidied up. This has been accomplished by restructuring the code to create and add the counters to the performance once of in the CRasConnection constructors.
• Removed reference to source code of RasMan app which is now not available.

API Reference

The API consists of the class CRasConnection and the public member functions of the class CRasMonitor

CRasConnection::m_sName
CRasConnection::m_sDeviceType
CRasConnection::m_sDeviceName
CRasConnection::m_ConnectionTime
CRasConnection::m_DialTime
CRasConnection::m_bConnected
CRasConnection::m_ConnectDuration
CRasConnection::m_DialDuration
CRasConnection::m_HangupTime
CRasConnection::m_dwConnectionSpeed
CRasConnection::m_dwBytesSent
CRasConnection::m_dwBytesReceived
CRasMonitor::Start
CRasMonitor::Stop

CRasConnection::m_sName

Remarks

A string that specifies the phone-book entry used to establish the remote access connection. If the connection was established using an empty entry name, this string consists of a “.” followed by the connection phone number.

CRasConnection::m_sDeviceType

Remarks

A string that specifies the type of the current device, if available. For example, common device types supported by RAS are “modem”, “pad”, “switch”, “isdn”, or “null”.

CRasConnection::m_sDeviceName

Remarks

A string that specifies the name of the current device, if available. This would be the name of the modem for example, “Hayes Smartmodem 2400”; the name of the PAD, for example “US Sprint”; or the name of a switch device, for example “Racal-Guardata”.

CRasConnection::m_ConnectionTime

Remarks

A SYSTEMTIME representation of when this connection was made/connected. The time stored is Local and not UCT.

CRasConnection::m_DialTime

Remarks

A SYSTEMTIME representation of when this connection was dialed / attempted. The time stored is Local and not UCT. The dial time will always be more historic than the connection for any connection.

CRasConnection::m_ConnectDuration

Remarks

The number of seconds for which this connection was active.

CRasConnection::m_DialDuration

Remarks

The number of seconds taken to make the connection for which this RAS connection.

CRasConnection::m_HangupTime

Remarks

A SYSTEMTIME representation of when this connection was closed. The time stored is Local and not UCT.

CRasConnection::m_dwConnectionSpeed

Remarks

The connection speed in bits per second for this connection. Please note that this value is always reported as 0 on NT as currently there is no documented way of retrieving this value on NT.  Another point to bear in mind is that on 95/98, this is the accumulated connection speed of all current RAS connections. This means that if you are using multilink features or have two separate RAS connections active at the one time, then this value will be the total of both connections.

CRasConnection::m_dwBytesSent

Remarks

The total number of bytes transmitted by this connection. Please note that this value is a total for all RAS connections similar to the Connection Speed above.

CRasConnection::m_dwBytesReceived

Remarks

The total number of bytes received by this connection. Please note that this value is a total for all RAS connections similar to the Connection Speed above.

CRasMonitor::Start

BOOL CRasMonitor::Start(CWnd* pNotifyWnd, UINT nNotifyMessage);

Return Value

TRUE if monitoring of RAS connections has started otherwise FALSE.

Parameters

pNotifyWnd Window to send notification messages to

nNotifyMessage the window message to use for notification messages

Remarks

Starts monitoring of active RAS connections. If the call fails, you should use GetLastError to determine the reason. When certain RAS related events occur the class will send a "nNotifyMessage" to pNotifyWnd. The meaning of WPARAM and LPARAM are as follows

See Also

CRasMonitor::Stop

CRasMonitor::Stop

BOOL CRasMonitor::Stop();

Return Value

TRUE if monitoring of RAS connections has stopped otherwise FALSE.

Parameters

None

Remarks

Stops monitoring of active RAS connections. If the call fails, you should use GetLastError to determine the reason.

See Also

CRasMonitor::Start

CRasMonitor::OnDial

virtual void CRasMonitor::OnDial(const CRasConnection& connection);

Return Value

None

Parameters

connection A class representation of the RAS connection which has just been dialled.

Remarks

Derived classes are responsible for implementing their own version of OnConnect.

See Also

CRasMonitor::OnConnect

CRasMonitor::OnConnect

virtual void CRasMonitor::OnConnect(const CRasConnection& connection);

Return Value

None

Parameters

connection A class representation of the RAS connection which has just become active.

Remarks

Derived classes are responsible for implementing their own version of OnConnect.

See Also

CRasMonitor::OnDisconnect

CRasMonitor::OnDisconnect

virtual void CRasMonitor::OnDisconnect(const CRasConnection& connection);

Return Value

None

Parameters

connection A class representation of the RAS connection which has just being closed.

Remarks

Derived classes are responsible for implementing their own version of OnDisconnect. If you look at the sample app "RasMan", you will see that it does a SendMessage to the mainfrm window.

See Also

CRasMonitor::OnConnect

CRasMonitor::OnCheck

virtual void CRasMonitor::OnCheck(RASCONN* pConnections, DWORD dwConnections);

Return Value

None

Parameters

pConnections pointer to an array of the currently active connections. The structure used is the same as that used by native SDK RAS calls.

dwConnections The number of elements in pConnections.

Remarks

This function is called every second internally by CRasMonitor. The parameters it is called with include the an array of the newly active connections. The implementation in CRasMonitor does 2 things.

1. Iterate through all the previously active connections which has now disappeared and call the virtual OnDisconnect function for that connection.
2. For any new connections which have appeared call the virtual OnConnect for that connection and add it to the internal array of active connections.

PLANNED ENHANCEMENTS

• Package the code up into an OCX to allow non MFC apps to use the code.
• If you have any other suggested improvements, please let me know so that I can incorporate them into the next release.

CONTACTING THE AUTHOR

PJ Naughter
Email: pjn@indigo.ie
Web: http://indigo.ie/~pjn
25 January 2000