The Win32 Foundation Classes (WFC) - Version 45

Sam Blackburn

Rate me:

4.93/5 (40 votes)

16 May 2000

470.3K

12.7K

280

The Win32 Foundation Classes (WFC) are a library of C++ classes that extend Microsoft Foundation Classes (MFC) beyond mere GUI applications, and provide extensive support for system and NT specific applications

wfc.zip
- wfc
  - BACKUP.CMD
  - HTML
    - Document.cmd
    - web
      - CLASSES.HTM
      - Coding.htm
      - gather.cmd
      - HOMEPAGE.HTM
      - pax.HTM
      - Release30.htm
      - Release31.htm
      - Release32.htm
      - Release33.htm
      - release34.htm
      - Release35.htm
      - Release36.htm
      - Release37.htm
      - Release38.htm
      - Release39.htm
      - Release41.htm
      - Release42.htm
      - Release43.htm
      - Release44.htm
      - Samples.htm
      - TechNotes.htm
      - TIMEBEG.HTM
      - TITLE.HTM
      - WFC.HTM
      - WTN001.htm
      - WTN002.htm
      - WTN003.htm
      - WTN004.htm
      - WTN005.htm
      - WTN006.htm
      - WTN007.htm
  - INCLUDE
    - CBase64Coding.hpp
    - CBitArray.hpp
    - CBubble.hpp
    - CConstellation.hpp
    - CCriticalSection.hpp
    - CCrypto.hpp
    - CDataArchive.hpp
    - CDataChunk.hpp
    - CDataFile.hpp
    - CDataLocation.hpp
    - CDataMemory.hpp
    - CDataParser.hpp
    - CDataSocket.hpp
    - CDesktop.hpp
    - CDragQuery.hpp
    - CEventLogRecord.HPP
    - CEVNTLOG.HPP
    - CExtensibleMarkupLanguage.hpp
    - CFile.hpp
    - CFile64.hpp
    - CFileDirectory.hpp
    - CFileTime.hpp
    - CFileTransferProtocol.hpp
    - CGarbageCollector.hpp
    - CJulianDate.hpp
    - CMemoryFile.hpp
    - CMicrosoftTape.hpp
    - CMixer.hpp
    - CNetConn.hpp
    - CNetFile.hpp
    - CNetInfo.hpp
    - CNetMesg.hpp
    - CNetRsrc.hpp
    - CNetSess.hpp
    - CNetShar.hpp
    - CNetUser.hpp
    - CNetWkst.hpp
    - CNetwork.hpp
    - CNetworkScheduleJob.hpp
    - CNMPIPE.HPP
    - CParsePoint.hpp
    - CPasswordChangeFilter.hpp
    - CPhysicalDiskFile.hpp
    - CPing.hpp
    - CQueue.hpp
    - CRandomNumberGenerator.hpp
    - CRandomNumberGenerator2.hpp
    - CRAS.HPP
    - CRASADM.HPP
    - CRASPORT.HPP
    - CReedSolomonErrorCorrectionCode.hpp
    - CREGISTY.HPP
    - CSecureChannel.hpp
    - CServer.hpp
    - CService.hpp
    - CServiceApplication.hpp
    - CSharedMemoryObject.hpp
    - CSMTF.hpp
    - CSquigl.hpp
    - CSuperRandomNumberGenerator.hpp
    - CSvcMgr.hpp
    - CSystemTime.hpp
    - ctape.hpp
    - CTimeEx.hpp
    - CUNC.HPP
    - CURL.HPP
    - CUUCoding.hpp
    - CVolume.hpp
    - CWait.hpp
    - CWeather.hpp
    - CXMLArchive.hpp
    - DCB.HPP
    - DrawGrid.hpp
    - DrawObj.hpp
    - DumyFile.hpp
    - Guards.hpp
    - LSOCKETS.HPP
    - LZFILE.HPP
    - Mfc2Stl.h
    - Modem.hpp
    - mtf.h
    - origianl_CFile.hpp
    - OVRLPD.HPP
    - Pager.hpp
    - PortInformation.hpp
    - RIFF.hpp
    - samtf.h
    - Serial.hpp
    - ServiceConfiguration.hpp
    - SkyWord.hpp
    - SOCKETS.HPP
    - SockFile.hpp
    - SprintSpectrum.hpp
    - stlxml.h
    - Structs.hpp
    - TSOCKETS.HPP
    - WFC.H
    - wfc_coverage.h
    - wfc_crypto.h
    - wfc_linker_setup.h
    - wfc_thread_information_block.h
    - wfc_undocumented.h
    - wfcfloat.h
    - WFCTrace.hpp
    - WindowsSockets.hpp
  - InternalCompilerErrors.txt
  - LIB
    - make.cmd
    - types.xml
    - WFC.dsp
    - WFC.dsw
    - WFC.mak
    - wfcvc42.mak
  - makewebsite.cmd
  - old_paxit.cmd
  - PAXIT.CMD
  - Renames.txt
  - SRC
    - ATCP.cpp
    - CBase64Coding.cpp
    - CBitArray.cpp
    - CBubble.cpp
    - CConstellation.cpp
    - CCriticalSection.cpp
    - CCriticalSectionGuard.cpp
    - CCryptographicAlgorithm.cpp
    - CCryptographicHash.cpp
    - CCryptographicKey.cpp
    - CCryptographicProvider.cpp
    - CCryptography.cpp
    - CDataArchive.cpp
    - CDataChunk.cpp
    - CDataFile.cpp
    - CDataMemory.cpp
    - CDataParser.cpp
    - CDataSocket.cpp
    - CDesktop.cpp
    - CDragQuery.cpp
    - CEventLogRecord.CPP
    - CEVNTLOG.CPP
    - CExtensibleMarkupLanguageAttribute.cpp
    - CExtensibleMarkupLanguageDocument.cpp
    - CExtensibleMarkupLanguageElement.cpp
    - CExtensibleMarkupLanguageEntities.cpp
    - CFile.cpp
    - CFile64.cpp
    - CFileDirectory.cpp
    - CFileTime.cpp
    - CFileTransferProtocol.cpp
    - CGarbageCollector.cpp
    - CJulianDate.cpp
    - CMemoryFile.cpp
    - CMicrosoftTape.cpp
    - CMixer.cpp
    - CMixerCapabilities.cpp
    - CMixerControl.cpp
    - CMixerControlDetails.cpp
    - CMixerControlDetailsData.cpp
    - CMixerControlInstance.cpp
    - CMixerDestination.cpp
    - CMixerLine.cpp
    - CMixerSource.cpp
    - CMixerSourceSelector.cpp
    - CMixerSpeakers.cpp
    - CMixerSwitchControl.cpp
    - CMixerVolumeControl.cpp
    - CMixerWaveIn.cpp
    - CNetConn.cpp
    - CNetFile.cpp
    - CNetInfo.cpp
    - CNetMesg.cpp
    - CNetRsrc.cpp
    - CNetScheduleJob.cpp
    - CNetSess.cpp
    - CNetShar.cpp
    - CNetWkst.cpp
    - CNetwork.cpp
    - CNetworkConnectionInformation.cpp
    - CNetworkFileInformation.cpp
    - CNetworkResourceInformation.cpp
    - CNetworkSessionInformation.cpp
    - CNetworkUser.cpp
    - CNetworkUserInformation.cpp
    - CParsePoint.cpp
    - CPasswordChangeFilter.cpp
    - CPhysicalDiskFile.cpp
    - CPing.cpp
    - CPingRes.cpp
    - CQueue.cpp
    - CRandomNumberGenerator.cpp
    - CRandomNumberGenerator2.cpp
    - CRAS.CPP
    - CRASADM.CPP
    - CReedSolomonErrorCorrectionCode.cpp
    - CRIFFChunk.cpp
    - CSecureChannel.cpp
    - CServer.cpp
    - CService.cpp
    - CServiceApplication.cpp
    - CSharedMemoryObject.cpp
    - CSMTF.cpp
    - CSquigl.cpp
    - CSuperRandomNumberGenerator.cpp
    - CSvcMgr.cpp
    - CSystemTime.cpp
    - CTape.cpp
    - CTapeGetMediaParameters.cpp
    - CTimeEx.cpp
    - CUNC.CPP
    - CURL.CPP
    - CUUCoding.cpp
    - CVolume.cpp
    - CWait.cpp
    - CWeather.cpp
    - CXMLArchive.cpp
    - DCB.CPP
    - doc.cmd
    - DrawGrid.cpp
    - DrawObj.cpp
    - DumyFile.cpp
    - IPCP.cpp
    - IPXCP.cpp
    - LMErr.cpp
    - LSOCKETS.CPP
    - LZFile.cpp
    - Modem.CPP
    - NAMDPIPE.CPP
    - NBFCP.cpp
    - original_CFile.cpp
    - OVRLPD.CPP
    - Pager.cpp
    - PortInformation.CPP
    - RASCP.CPP
    - RASNBPCP.CPP
    - RASPORT.CPP
    - RASPPPCR.cpp
    - RASPSTAT.CPP
    - REGISTRY.CPP
    - RemoteAccessServicePort.CPP
    - RemoteAccessServiceUser.cpp
    - Serial.CPP
    - ServiceConfiguration.cpp
    - SkyWord.cpp
    - SOCKETS.CPP
    - SockFile.cpp
    - SprintSpectrum.cpp
    - STL_CByteArray.cpp
    - STL_CDWordArray.cpp
    - STL_CPtrArray.cpp
    - STL_CString.cpp
    - STL_CStringArray.cpp
    - STL_CUIntArray.cpp
    - STL_CWordArray.cpp
    - Structs.cpp
    - TALKSOCK.CPP
    - U2A_A2U.cpp
    - wfc_am_i_administrator.cpp
    - wfc_append_string_to_CByteArray.cpp
    - wfc_append_text_to_edit_control.cpp
    - wfc_close_handle.cpp
    - wfc_convert_double_null_terminated_string.cpp
    - wfc_convert_double_null_terminated_UNICODE_string.cpp
    - wfc_convert_lpwstr_to_cstring.cpp
    - wfc_create_hard_link.cpp
    - wfc_delete_oldest_file.cpp
    - wfc_enable_all_privileges.cpp
    - wfc_enable_privilege.cpp
    - wfc_get_day_of_week.cpp
    - wfc_get_directory_usage_percentage.cpp
    - wfc_get_error_string.cpp
    - wfc_get_executable_directory.cpp
    - wfc_get_filename_from_handle.cpp
    - wfc_get_list_of_programs_that_run_when_a_user_logs_on.cpp
    - wfc_get_operating_system_version_string.cpp
    - wfc_get_web_page.cpp
    - wfc_move_file_at_reboot.cpp
    - wfc_parse_iso_8601_string.cpp
    - wfc_set_thread_name.cpp
    - wfc_start_screen_saver.cpp
    - wfc_undocumented_get_system_process_list.cpp
    - wfc_UNICODE_floating_point_routines.cpp
    - WfcTrace.cpp
    - xml_character_test_routines.cpp
  - WFC World.txt
  - wfcfaq.htm
sample.zip
- sample
  - Sample
    - ADO2XML
      - ADO2XML.dsp
      - ADO2XML.dsw
      - ado2xml.h
      - ado2xml.xml
      - CDatabaseParameters.cpp
      - CDatabaseParameters.hpp
      - convert_DataTypeEnum_to_string.cpp
      - convert_desired_tables.cpp
      - convert_table.cpp
      - get_blob.cpp
      - get_table_names.cpp
      - main.cpp
      - normalize_string.cpp
      - open_connection_to_database.cpp
      - output_field.cpp
      - output_schema.cpp
      - output_types.cpp
      - print_COM_error.cpp
      - print_provider_error.cpp
      - replace.cpp
    - ChangeServiceConfiguration
      - ChangeServiceConfiguration.cpp
      - ChangeServiceConfiguration.dsp
      - ChangeServiceConfiguration.dsw
      - ChangeServiceConfiguration.mak
    - ClockSync
      - ClockSync.cpp
      - ClockSync.dsp
      - ClockSync.dsw
      - ClockSync.mak
    - Counter
      - Counter.cpp
      - counter.h
      - counter.mak
      - CPCD.cpp
      - CPCD.hpp
      - CPerfDef.cpp
      - CPerfDef.hpp
      - CPerformanceCounterData.hpp
      - CPerformanceCounterDefinition.cpp
      - CPerformanceCounterDefinition.hpp
      - CPerformanceData.cpp
      - CPerformanceData.hpp
      - CPerformanceInstance.cpp
      - CPerformanceInstance.hpp
      - CPerformanceObject.cpp
      - CPerformanceObject.hpp
      - test.cpp
    - Crypto
      - Crypto.cpp
      - Crypto.dsp
      - Crypto.dsw
      - Crypto.mak
    - CScript
      - CScript.dsp
      - CScript.dsw
      - main.cpp
    - Data
      - CSimpleClass.hpp
      - Receiver
        
        Receiver.cpp
        
        Receiver.dsp
        
        Receiver.dsw
      - Sender
        
        Sender.cpp
        
        Sender.dsp
        
        Sender.dsw
    - DeMangle
      - DeMangle.dsp
      - DeMangle.dsw
      - main.cpp
    - DriverMover
      - DriverMover.cpp
      - DriverMover.dsp
      - DriverMover.dsw
      - DriverMover.h
      - DriverMover.rc
      - DriverMoverDialog.cpp
      - DriverMoverDialog.h
      - ReadMe.txt
      - res
        
        DriverMover.ico
        
        DriverMover.rc2
      - resource.h
      - StdAfx.cpp
      - StdAfx.h
    - dump_ntfs_streams.cpp
    - DumpEventLog
      - DumpEventLog.cpp
      - DumpEventLog.mak
    - EnableRASLogging
      - EnableRASLogging.cpp
      - EnableRASLogging.mak
    - EventPager
      - EventPager.cpp
      - EventPager.dsp
      - EventPager.dsw
      - EventPager.mak
      - MAKEMC.CMD
      - messages.h
      - messages.mc
      - messages.rc
    - GetWebPage
      - CNNWeather.cpp
      - CStockQuote.hpp
      - GetStockQuote.cpp
      - GetWebPage.cpp
      - GetWebPage.dsp
      - GetWebPage.dsw
      - GetWebPage.mak
      - wc.html
      - WeatherChannelWeather.cpp
    - HTML
      - html.cpp
      - html.dsp
      - html.dsw
      - html.mak
    - KillDoc
      - KillDoc.dsp
      - KillDoc.dsw
      - main.cpp
    - LastEvent
      - LastEvent.cpp
      - LastEvent.dsp
      - LastEvent.dsw
      - LastEvent.mak
    - Listen
      - Listen.cpp
      - Listen.dsp
      - Listen.dsw
      - Listen.mak
      - sl.cpp
    - ListProcesses
      - list_processes.cpp
      - ListProcesses.dsp
      - ListProcesses.dsw
      - ListProcesses.h
      - main.cpp
      - print_process_list.cpp
    - MAKEMC.CMD
    - Map2Def
      - Map2Def.cpp
      - Map2Def.dsp
      - Map2Def.dsw
      - Map2Def.mak
    - Microphone
      - main.cpp
      - Microphone.dsp
      - Microphone.dsw
    - MIME2HTML
      - Debug
        
        mime.html
      - dump_mime_mappings.cpp
      - dump_mime_type.cpp
      - get_command_line.cpp
      - main.cpp
      - MIME2HTML.dsp
      - MIME2HTML.dsw
      - MIME2HTML.h
      - normalize_string.cpp
      - replace.cpp
    - PasswordFilter
      - DLL
        
        InitializeChangeNotify.cpp
        
        PasswordChangeNotify.cpp
        
        PasswordDLL.cpp
        
        PasswordDLL.dsp
        
        PasswordDLL.dsw
        
        PasswordDLL.h
      - PasswordFilter.cpp
      - PasswordFilter.dsp
      - PasswordFilter.dsw
    - Ping
      - Ping.cpp
      - Ping.dsp
      - Ping.dsw
      - Ping.mak
    - Pinger
      - MAKEMC.CMD
      - messages.h
      - MESSAGES.MC
      - messages.rc
      - Pinger.cpp
      - Pinger.dsp
      - Pinger.dsw
      - Pinger.mak
      - PINGER.RC
      - Pinger.ver
      - resource.h
    - RasAdmin
      - RasAdmin.cpp
      - RasAdmin.dsp
      - RasAdmin.dsw
      - RasAdmin.mak
    - Serial
      - Serial.cpp
      - Serial.dsp
      - Serial.dsw
      - Serial.h
      - Serial.mak
    - SerialTest
      - Normal
        
        Receiver
        
        compute_checksum.cpp
        
        main.cpp
        
        Receiver.dsp
        
        Receiver.dsw
        
        receiver.h
        
        Sender
        
        main.cpp
        
        prepare_buffer.cpp
        
        Sender.dsp
        
        Sender.dsw
        
        sender.h
    - Service
      - Service.cpp
      - Service.dsp
      - Service.dsw
      - Service.mak
    - SkyPage
      - SKYPAGE.CPP
      - SkyPage.dsp
      - SkyPage.dsw
      - SkyPage.mak
    - SprintSpectrum
      - SprintSpectrum.cpp
      - SprintSpectrum.dsp
      - SprintSpectrum.dsw
      - SprintSpectrum.mak
    - Squiggle
      - Squiggle.cpp
      - Squiggle.mak
    - TortureXML
      - create_huge_character_reference.cpp
      - create_huge_element.cpp
      - create_huge_element_and_attribute.cpp
      - create_huge_element_name.cpp
      - create_huge_encoding.cpp
      - create_huge_version.cpp
      - main.cpp
      - TortureXML.dsp
      - TortureXML.dsw
      - TortureXML.h
    - USNOTime
      - main.cpp
      - USNOTime.dsp
      - USNOTime.dsw
    - WatchDog
      - MAKEMC.CMD
      - messages.h
      - messages.mc
      - messages.rc
      - WatchDog.cpp
      - WatchDog.dsp
      - WatchDog.dsw
      - WatchDog.mak
      - WatchDog.rc
      - WatchDog.ver
    - Wfc2Html
      - CCPPToHTMLTranslator.cpp
      - CCPPToHTMLTranslator.hpp
      - load_translator.cpp
      - main.cpp
      - translate_file.cpp
      - Wfc2Html.dsp
      - Wfc2Html.dsw
      - wfc2html.h
    - WinPage
      - res
        
        WinPage.ico
        
        WinPage.rc2
      - resource.h
      - WinPage.cpp
      - WinPage.dsp
      - WinPage.dsw
      - WinPage.h
      - WinPage.mak
      - WinPage.rc
      - WinPageDlg.cpp
      - WinPageDlg.h
    - XML
      - Debug
        
        test2.xml
      - dump_element.cpp
      - dump_tags.cpp
      - get_bytes.cpp
      - main.cpp
      - my_xml.h
      - parse_document.cpp
      - poem.xml
      - test.xml
      - TestSuite.xml
      - XML.DSP
      - XML.dsw
    - XMLCheck
      - check_xml_file.cpp
      - Debug
        
        check.txt
        
        test.xml
        
        TestSuite.xml
        
        TestSuite2.xml
        
        txtfirst.xml
        
        txtlast.xml
      - main.cpp
      - XML
        
        a2.xml
      - XMLCheck.dsp
      - XMLCheck.dsw
      - XMLCheck.h
      - XMLCheck.mak
    - XMLExplorer
      - CMainFrame.cpp
      - CMainFrame.h
      - CXMLExplorerDocument.cpp
      - CXMLExplorerDocument.h
      - CXMLExplorerView.cpp
      - CXMLExplorerView.h
      - MyListView.cpp
      - MyListView.h
      - MyTreeView.cpp
      - MyTreeView.h
      - ReadMe.txt
      - res
        
        bitmap1.bmp
        
        CXMLExplorerDocument.ico
        
        Toolbar.bmp
        
        XMLExplorer.ico
        
        XMLExplorer.rc2
      - resource.h
      - StdAfx.cpp
      - StdAfx.h
      - test.xml
      - XMLExplorer.cpp
      - XMLExplorer.dsp
      - XMLExplorer.dsw
      - XMLExplorer.h
      - XMLExplorer.rc
    - XMLUser
      - add_current_time.cpp
      - add_level.cpp
      - add_machine_name.cpp
      - add_to_xml.cpp
      - enumerate_users.cpp
      - main.cpp
      - parse_document.cpp
      - save_document.cpp
      - users.xml
      - XMLUser.dsp
      - XMLUser.dsw
      - XMLUser.h
  - TEST
    - CQueue_stress_test.cpp
    - dumpexports.cpp
    - Grid
      - Grid.cpp
      - Grid.mak
    - MESSAGES.MC
    - Output.txt
    - Pipe
      - pipe.CPP
      - Pipe.h
      - Pipe.mak
      - Server.CPP
    - REPERR.CPP
    - TCLZFile.CPP
    - TCNet.CPP
    - TCNetCon.CPP
    - TCNetFil.CPP
    - TCNetshs.CPP
    - TCNetUSR.CPP
    - TCNSrc.cpp
    - TCRAS.CPP
    - TCRASPORT.CPP
    - TCREG.CPP
    - TCSess.CPP
    - TCSrvr.CPP
    - TCSvcMgr.CPP
    - TCTape.cpp
    - TEST.CPP
    - TEST.dsp
    - TEST.dsw
    - TEST.H
    - TEST.MAK
    - test_CBase64Coding.cpp
    - test_CBitArray.cpp
    - test_CByteArray.cpp
    - test_CDataParser.cpp
    - test_CDWordArray.cpp
    - test_CFileTransferProtocol.cpp
    - test_CJulianDate.cpp
    - test_CNetwork.CPP
    - test_CPtrArray.cpp
    - test_CQueue.cpp
    - test_CRandomNumberGenerator.cpp
    - test_CReedSolomonErrorCorrectionCode.cpp
    - test_CSerialFile.cpp
    - test_CString.cpp
    - test_CSystemTime.cpp
    - test_CUIntArray.cpp
    - test_CUUCoding.cpp
    - test_CWordArray.cpp
    - test_CXMLDocument.cpp
    - test_XML.cpp
    - TEVNTLOG.CPP
    - TURL.CPP
    - XMLConformanceTest
      - main.cpp
      - XMLConformanceTest.dsp
      - XMLConformanceTest.dsw
      - XMLConformanceTest.h
html.zip
- HTML
  - html.cpp
  - html.dsp
  - html.dsw
  - html.mak

#include <wfc.h>
#pragma hdrstop

/*
** Author: Samuel R. Blackburn
** Internet: wfc@pobox.com
**
** You can use it any way you like as long as you don't try to sell it.
**
** Any attempt to sell WFC in source code form must have the permission
** of the original author. You can produce commercial executables with
** WFC but you can't sell WFC.
**
** Copyright, 2000, Samuel R. Blackburn
**
** $Workfile: Pager.cpp $
** $Revision: 22 $
** $Modtime: 1/17/00 9:28a $
** $Reuse Tracing Code: 1 $
*/

#if defined( _DEBUG ) && ! defined( WFC_STL )
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#define new DEBUG_NEW
#endif // _DEBUG

CPager::CPager()
{
   WFCLTRACEINIT( TEXT( "CPager::CPager()" ) );
   WFCTRACEVAL( TEXT( "pointer is " ), (VOID *) this );
   Empty();
   SetNumberOfRetries( 3 );
}

CPager::CPager( const CPager& source )
{
   WFCLTRACEINIT( TEXT( "CPager::CPager( CPager * )" ) );
   WFCTRACEVAL( TEXT( "pointer is " ), (VOID *) this );
   Copy( source );
}

CPager::CPager( const CPager * source )
{
   WFCLTRACEINIT( TEXT( "CPager::CPager( CPager * )" ) );
   WFCTRACEVAL( TEXT( "pointer is " ), (VOID *) this );
   Copy( source );
}

CPager::~CPager()
{
   WFCLTRACEINIT( TEXT( "CPager::~CPager()" ) );
   WFCTRACEVAL( TEXT( "pointer is " ), (VOID *) this );
   Empty();
}

void CPager::Copy( const CPager& source )
{
   WFCLTRACEINIT( TEXT( "CPager::Copy( CPager & )" ) );
   m_Account         = source.m_Account;
   m_ErrorCode       = source.m_ErrorCode;
   m_PhoneNumber     = source.m_PhoneNumber;
   m_Message         = source.m_Message;
   m_SerialSettings  = source.m_SerialSettings;
   m_NumberOfRetries = source.m_NumberOfRetries;
}

void CPager::Copy( const CPager * source )
{
   WFCLTRACEINIT( TEXT( "CPager::Copy( CPager * )" ) );
   ASSERT( source != NULL );
   ASSERT( source != this );

   if ( source == this )
   {
      return;
   }

   // We were passed a pointer, don't trust it

   try
   {
      if ( source != NULL )
      {
         Copy( *source );
      }
      else
      {
         Empty();
      }
   }
   catch( ... )
   {
      Empty();
   }
}

void CPager::Empty( void )
{
   WFCLTRACEINIT( TEXT( "CPager::Empty()" ) );
   m_Account.Empty();
   m_ErrorCode = 0;
   m_PhoneNumber.Empty();
   m_Message.Empty();
   m_SerialSettings.Empty();
   m_NumberOfRetries = 1;
}

void CPager::GetAccount( CString& account ) const
{
   WFCLTRACEINIT( TEXT( "CPager::GetAccount()" ) );
   account = m_Account;
}

DWORD CPager::GetErrorCode( void ) const
{
   WFCLTRACEINIT( TEXT( "CPager::GetErrorCode()" ) );
   return( m_ErrorCode );
}

void CPager::GetMessage( CString& message ) const
{
   WFCLTRACEINIT( TEXT( "CPager::GetMessage()" ) );
   message = m_Message;
}

DWORD CPager::GetNumberOfRetries( void ) const
{
   WFCLTRACEINIT( TEXT( "CPager::GetNumberOfRetries()" ) );
   return( m_NumberOfRetries );
}

void CPager::GetPhoneNumber( CString& phone_number ) const
{
   WFCLTRACEINIT( TEXT( "CPager::GetPhoneNumber()" ) );
   phone_number = m_PhoneNumber;
}

void CPager::GetSerialPort( CString& serial_settings ) const
{
   WFCLTRACEINIT( TEXT( "CPager::GetSerialPort()" ) );
   serial_settings = m_SerialSettings;
}

BOOL CPager::Send( void )
{
   WFCLTRACEINIT( TEXT( "CPager::Send()" ) );

   DWORD tries = 0;

   BOOL return_value = FALSE;

   // Number of Retries < 1 ain't valid, we will always try at least once

   DWORD number_of_tries = m_NumberOfRetries;

   if ( number_of_tries < 1 )
   {
      WFCTRACE( TEXT( "m_NumberOfRetries < 1 so setting tries to 1." ) );
      number_of_tries = 1;
   }

   WFCTRACEVAL( TEXT( "number of tries is " ), number_of_tries );

   while( tries < number_of_tries )
   {
      WFCTRACE( TEXT( "Calling m_Send()" ) );
      return_value = m_Send();

      if ( return_value != FALSE )
      {
         WFCTRACE( TEXT( "m_Send() returned TRUE." ) );
         return( return_value );
      }
      else
      {
         WFCTRACE( TEXT( "m_Send() returned FALSE, retrying" ) );
         tries++;
      }
   }

   return( return_value );
}

#if ! defined(  WFC_NO_SERIALIZATION )

void CPager::Serialize( CArchive& archive )
{
   WFCLTRACEINIT( TEXT( "CPager::Serialize()" ) );
   CObject::Serialize( archive );

   if ( archive.IsStoring() )
   {
      WFCTRACE( TEXT( "Storing" ) );
      archive << m_Account;
      archive << m_PhoneNumber;
      archive << m_Message;
      archive << m_SerialSettings;
      archive << m_ErrorCode;
      archive << m_NumberOfRetries;
   }
   else
   {
      WFCTRACE( TEXT( "Restoring" ) );
      archive >> m_Account;
      archive >> m_PhoneNumber;
      archive >> m_Message;
      archive >> m_SerialSettings;
      archive >> m_ErrorCode;
      archive >> m_NumberOfRetries;
   }
}

#endif // WFC_NO_SERIALIZATION

void CPager::SetAccount( const CString& account )
{
   WFCLTRACEINIT( TEXT( "CPager::SetAccount()" ) );
   m_Account = account;
}

void CPager::SetMessage( const CString& message )
{
   WFCLTRACEINIT( TEXT( "CPager::SetMessage()" ) );
   m_Message = message;
}

void CPager::SetNumberOfRetries( const DWORD retries )
{
   WFCLTRACEINIT( TEXT( "CPager::SetNumberOfRetries()" ) );
   m_NumberOfRetries = retries;
}

void CPager::SetPhoneNumber( const CString& phone_number )
{
   WFCLTRACEINIT( TEXT( "CPager::SetPhoneNumber()" ) );
   m_PhoneNumber = phone_number;
}

void CPager::SetSerialPort( const CString& serial_settings )
{
   WFCLTRACEINIT( TEXT( "CPager::SetSerialPort()" ) );
   m_SerialSettings = serial_settings;
}

CPager& CPager::operator = ( const CPager& source )
{
   WFCLTRACEINIT( TEXT( "CPager::operator = ( const CPager& )" ) );
   Copy( source );
   return( *this );
}

#if defined( _DEBUG ) && ! defined( WFC_NO_DUMPING )

void CPager::Dump( CDumpContext& dump_context ) const
{
   CObject::Dump( dump_context );

   dump_context << TEXT( "{\n" );
   dump_context << TEXT( "   m_Account is         \"" ) << (LPCTSTR) m_Account        << TEXT( "\"\n" );
   dump_context << TEXT( "   m_PhoneNumber is     \"" ) << (LPCTSTR) m_PhoneNumber    << TEXT( "\"\n" );
   dump_context << TEXT( "   m_Message is         \"" ) << (LPCTSTR) m_Message        << TEXT( "\"\n" );
   dump_context << TEXT( "   m_SerialSettings is  \"" ) << (LPCTSTR) m_SerialSettings << TEXT( "\"\n" );
   dump_context << TEXT( "   m_NumberOfRetries is  "  ) << m_NumberOfRetries          << TEXT( "\n" );
   dump_context << TEXT( "   m_ErrorCode is        "  ) << m_ErrorCode                << TEXT( "\n" );
   dump_context << TEXT( "}\n" );
}

#endif // _DEBUG

// End of source

#if 0
<HTML>

<HEAD>
<TITLE>WFC - CPager</TITLE>
<META name="keywords" content="WFC, MFC extension library, freeware class library, Win32, source code">
<META name="description" content="The C++ base class for sending messages to pagers.">
</HEAD>

<BODY>

<H1>CPager : CObject</H1>
$Revision: 22 $
<HR>

<H2>Description</H2>

This class is a virtual base class that describes the methods of dealing with pagers.

<H2>Data Members</H2>

None.

<H2>Methods</H2>

<DL COMPACT>

<DT><DFN><B>Copy</B></DFN><DD>Copies another CPager.

<DT><DFN><B>Empty</B></DFN><DD>Clears all internal data members.

<DT><DFN><B>GetAccount</B></DFN><DD>Retrieves the account string.

<DT><DFN><B>GetErrorCode</B></DFN><DD>Retrieves the error code for the
last function that failed.

<DT><DFN><B>GetMessage</B></DFN><DD>Retrieves the message that was/may be 
sent to the pager.

<DT><DFN><B>GetNumberOfRetries</B></DFN><DD>Retrieves the number of times
the class will attempt to resend the message if it fails.

<DT><DFN><B>GetPhoneNumber</B></DFN><DD>Retrieves the phone number of the
pager company's computer.

<DT><DFN><B>GetSerialPort</B></DFN><DD>Retrieves the name of the serial port in 
the "COM1:9600,n,8,1" format.

<DT><DFN><B>Send</B></DFN><DD>Method to call after all data members have been set.
This will actually dial the phone, log onto the service, send the message and
log off.

<DT><DFN><B>Serialize</B></DFN><DD>Saves/restores the object.

<DT><DFN><B>SetAccount</B></DFN><DD>Stores the account number to send a message to.

<DT><DFN><B>SetMessage</B></DFN><DD>Stores the message to be sent.

<DT><DFN><B>SetNumberOfRetries</B></DFN><DD>Sets the number of times Send() is to
try to get the message through before giving up.

<DT><DFN><B>SetPhoneNumber</B></DFN><DD>Sets the phone number for the pager company.

<DT><DFN><B>SetSerialPort</B></DFN><DD>Sets the serial port to use to contact the 
pager company.

</DL>

<H2>Example</H2>

<PRE><CODE>#include &lt;wfc.h&gt;
#pragma hdrstop

void wait_for_ring( void )
{
   <A HREF="WfcTrace.htm">WFCTRACEINIT</A>( TEXT( &quot;wait_for_ring()&quot; ) );

   <A HREF="SERIAL.htm">CSerialFile</A> serial;

   while( 1 )
   {
      _tprintf( TEXT( &quot;Opening serial port\n&quot; ) );

      if ( serial.Open( TEXT( &quot;COM1:57600,n,8,1&quot; ) ) != FALSE )
      {
         CString response;

         response = TEXT( &quot;ATM0\r\n&quot; );

         serial.Write( response );

         // See if the phone rang

         while ( serial.WaitForString( &quot;RING&quot;, 2, &amp;response ) == FALSE )
         {
            if ( response.GetLength() &gt; 0 )
            {
               _tprintf( TEXT( &quot;Didn't get RING, going to sleep \&quot;%s\&quot;\n&quot; ), (LPCTSTR) response );
            }

            ::Sleep( 10000 );
         }

         _tprintf( TEXT( &quot;Received a RING, waiting for them to end\n&quot; ) );

         while( serial.WaitForString( TEXT( &quot;RING&quot; ), 7 ) != FALSE )
         {
            // Do Nothing
         }

         _tprintf( TEXT( &quot;Closing serial port\n&quot; ) );

         serial.Close();

         CTime time_now( CTime::GetCurrentTime() );

         ::Sleep( 1000 );

         CString message;

         message.Format( TEXT( &quot;The phone rang at %s&quot; ), (LPCTSTR) time_now.Format( &quot;%H:%M:%S %d %b %y&quot; ) );

         CSprintSpectrum pager;

         pager.SetAccount( TEXT( &quot;4101234567&quot; ) );
         pager.SetMessage( message );

         _tprintf( TEXT( &quot;Calling pager.Send()\n&quot; ) );
         pager.Send();
      }
      else
      {
         _tprintf( TEXT( &quot;Can't open serial port\n&quot; ) );
      }

      ::Sleep( 1000 );
   }
}</CODE></PRE>

<HR><I>Copyright, 2000, <A HREF="mailto:wfc@pobox.com">Samuel R. Blackburn</A></I><BR>
$Workfile: Pager.cpp $<BR>
$Modtime: 1/17/00 9:28a $
</BODY>

</HTML>
#endif

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Written By

Sam Blackburn

United States

I'm just a simple little NT programmer. Most of the work I do is remote controlling equipment in real time. I started out using Windows 3.0. Then came 3.1 and then NT. I started using NT but unfortunately, Microsoft didn't. I started using MFC but unfortunately, Microsoft didn't (and still doesn't) put any real support for NT into MFC so I wrote a bunch of C++ classes to make my life easier. Like all class libraries, mine grew. Now I'm giving it away, I call it Win32 Foundation Classes.

Check out Sam's homepage at www.SamBlackburn.com/wfc/.

The Win32 Foundation Classes (WFC) - Version 45

License

Comments and Discussions