CPing v1.41 an MFC class to encapsulate "PING"

Included is an MFC class to support the PING/ICMP protocol. ICMP for those not familiar with all the internet protocols is the protocol used to retrieve information about how IP packets are routed.

Features

• Simple and clean C++ interface.
• The interface provided is synchronous which provides an easier programming model than using asynchronous sockets.
• A configurable timeout for the connection can be set through the class API.
• The classes are fully Unicode compliant and include Unicode built options in the workspace file.

The enclosed zip file contains the CPing source code and a simple test program to exercise all of the functions the classes provide.

Copyright

• You are allowed to include the source code in any product (commercial, shareware, freeware or otherwise) when your product is released in binary form.
• You are allowed to modify the source code in any way you want except you cannot modify the copyright details at the top of each module.
• If you want to distribute source code with your application, then you are only allowed to distribute versions released by the author. This is to maintain a single distribution point for the source code.

Updates

V1.0 (11 June 1998)

• Initial public release.

V1.1 (23 June 1998)

• The class now supports using Winsock 2 calls instead of using the ICMP dll. To use Winsock 2 calls in CPing instead of the ICMP dll, just define the preprocessor constant "CPING_USE_WINSOCK2" and don't forget to link to "ws2_32.lib".

V1.2 (30 July 1998)

• Can now use both Winsock 2 calls and ICMP style calls at the same time with the use of 2 preprocessor directives.
• sample program now use generic entry point _tmain.
• Got rid of a 2 level 4 compiler warnings.
• Fixed a problem with the cleanup of ICMP dll usage.
• Tidied up and optimized the usage of static variables.
• VC++ 6.0 project file is now used for the sample so beware.

V1.21 (9 November 1998)

• Now ships with a VC 5 workspace file instead of VC 6. This is mainly because a lot of people have not migrated to it yet.
• Workspace file now includes configurations to allow both the Winsock 2 and ICMP based code to be exercised.
• Fixed a level 4 warning which was occurring.
• Removed a number of compiler errors which was occurring when code was compiled to use the ICMP or Winsock 2.
• Fixed a bug whereby a ping to a non-existent host using the Winsock 2 method blocked indefinitely.
• Fixed a socket handle leak which was occurring if the Winsock 2 method of pinging was used.
• Fixed error in API documentation when compared with the actual header file.
• Fixed error in API documentation regarding default timeouts value.

V1.22 (1 March 2000)

• Fixed a problem where I was incorrectly overwritting memory in the function FillIcmpData.
• tidied up the console info issued by CPing.
• Minor changes to the way the demo program is initialized (main Vs tmain etc.)

V1.23 (15 July 2001)

• Updated copyright information
• Code now automatically pulls in the Winsock 2 libraries as and when needed

V1.24 (12 January 2002)

• Updated copyright information.
• Now initializes Winsock 2.0 instead of Winsock 2.1. Thanks to Lev Elbert for spotting this problem.

V1.3 (25 February 2002)

• Winsock 2 code path now allows you to bind the socket to a specific NIC. This can prove useful when you want to run a targeted ping request on a mulithoned machine.
• Tidied up the code in the sample application 
• Provide a complete set of command line options for the sample app. It now provides almost a 1 - 1 implementation of the built in Ping options.
• Completly reworked and recoded all the CPing code.
• Client code is now responsible for initializing Winsock instead of having it embedded in the CPing code.

23 March 2002

• Fixed an issue in the sample app which could result in a crash if the app was requested to resolve host names but the lookup fails. The CPing code has not been updated just the sample app code.

V1.31 (5 May 2002)

• Now includes a EchoReplyStatus in CPingReply structure if CPING_NO_ICMP is not defined.

V1.32 (22 November 2002)

• Fixed an issue in the calculation of the packet size when sending using raw sockets.
• Default sample now uses a default TTL of 30
• Changes the nPacketSize parameter to the Ping method to be nDataSize which is what it really is.
• Reviewed all the TRACE messages for correctness
• Made all the helper functions used by the code member functions of the class
• General tidy up of the various defines
• Winsock 2 version of ping now allows you to specify the sequence number of the packet. This allows the ping to exclude packets from the same process id which are being generated by for example another thread.
• Fixed a bug in the call to recvfrom. The receive buffer size was not being specified correctly.
• ICMP response packets from other processes are now ignored when waiting for an ICMP response
• ICMP response packets from the same process but which have an incorrect sequence number are now ignored when waiting for an ICMP response.
• Fix a resource leak of a socket when unexpected failures occur in the CPing::PingUsingWinsock function

V1.33 (10 March 2003)

• Fixed a bug where using PingUsingWinsock and setting the data size greater than 1004 appears to cause Winsock error 10040 - The datagram is too large to fit into the buffer and is truncated. Thanks to Paul Golightly for reported this and provided the fix.

V1.34 (13 March 2003)

• Fixed a bug in CPing::IsSocketReadible in the setup of the timval structure. Thanks to "InBloom Support" for reporting this.

27 June 2003

• Updated the documentation including description of PingUsingWinsock function plus a general review

V1.35 (23 November 2003)

• Fixed a level 4 warning in VC 6 in the function CPing::PingUsingWinsock.

V1.36 (12 April 2004)

• Fixed a bug in the declaration of h_len and version in the IP_HEADER structure. Also made the source and destination IP addresses longs instead of ints to avoid any porting problems. Thanks to Yuh-Rong Leu for reporting this problem.
• Fixed a bug in PingUsingWinsock when a timeout occurs and it returns TRUE. Thanks to Yuh-Rong Leu for reporting this problem.
• Updated the documentation to refer to using the value from GetCurrentThreadId() for the nSequenceNumber parameter when calling the PingUsingWinsock function. Again thanks to Yuh-Rong Leu for reporting this issue.
• Fixed an issue in DecodeResponse where if bTryAgain was set to TRUE, the return value was incorrectly also being set to TRUE. Thanks to Yuh-Rong Leu for reporting this issue.

V1.37 (11 June 2005)

• Reviewed all TRACE statements for correctness. Thanks to "Grenal" for reporting this issue.
• Checked all premature return points in the codebase to ensure the last error value is preserved.
• Fixed an unreferrenced variable in DecodeResponse function when code is compiled with Visual Studio .NET 2003

V1.38 (31 July 2005)

• When sending a ping, the allowable size of the data in the packet can now be anywhere from 0 to 65500. Previosuly sending a ping using Winsock was limited to a data size of 1024 and when using ICMP.dll, the size was limited to 255. Thanks to Leon Luu for reporting this issue.

V1.39 (31 July 2005)

• Now the PingUsingICMP method using the versions provided in the IP Helper dll namely "Iphlpapi.dll" before falling back to "ICMP.dll".
• Tidied up the various ICMP defines by making them part of the _CPING_ICMP class

V1.40 (10 July 2006)

• Updated copyright details
• The code now requires the Platform SDK if compiled using VC 6.
• Integrated the functionality of _CPING_ICMP class into CPing
• Optimized CPingReply constructor code
• Code now uses newer C++ style casts instead of C style casts.
• Addition of CPING_EXT_CLASS macro to allow the code to be easily added to an extension dll.
• Code now uses newer C++ style casts instead of C style casts.
• Updated the code to clean compile on VC 2005.
• Updated documentation to use the same style as the web site.

V1.41 (7 June 2008)

• Updated copyright details
• Updated the sample app to clean compile on VC 2008
• Code now compiles cleanly using Code Analysis (/analyze)
• The code has now been updated to support VC 2005 or later only
• Replaced all calls to ZeroMemory with memset
• Code now uses ATL::CHeapPtr for managed raw buffers
• The "Bind", "FillIcmpData", "DecodeResponse" and "GenerateIPChecksum" methods have been made virtual. This for example allows client code to decide what data gets put into ICMP request packets. Thanks to Dinci Glas for prompting this update.