The Win32 Foundation Classes (WFC) - Version 45

Sam Blackburn

Rate me:

4.93/5 (40 votes)

16 May 2000

470.4K

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: cnetwork.cpp $
** $Revision: 41 $
** $Modtime: 5/02/00 6:03p $
** $Reuse Tracing Code: 1 $
*/

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

#if ! defined(  WFC_NO_SERIALIZATION )
IMPLEMENT_SERIAL( CNetwork, CObject, 1 )
#endif // WFC_NO_SERIALIZATION

#if defined( _DEBUG ) && ! defined( WFC_STL )
#define new DEBUG_NEW
#endif // _DEBUG

/*
** CNetwork stuff
*/

CNetwork::CNetwork( LPCTSTR machine_name )
{
   WFCLTRACEINIT( TEXT( "CNetwork::CNetwork( LPCTSTR )" ) );
   WFCTRACEVAL( TEXT( "pointer is " ), (VOID *) this );
   m_Initialize();
   Open( machine_name );
}

CNetwork::~CNetwork()
{
   WFCLTRACEINIT( TEXT( "CNetwork::~CNetwork()" ) );
   WFCTRACEVAL( TEXT( "pointer is " ), (VOID *) this );
   Close();
   m_Initialize();
}

BOOL CNetwork::AbortShutdown( void )
{
   WFCLTRACEINIT( TEXT( "CNetwork::AbortShutdown()" ) );

   HANDLE token_handle = NULL;

   if ( ::OpenProcessToken( ::GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &token_handle ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't OpenProcessToken()" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   TOKEN_PRIVILEGES token_privileges;

   ::ZeroMemory( &token_privileges, sizeof( token_privileges ) );

   LPCSTR machine_name = NULL;

   // Check to see if we've opened ourselves...

   TCHAR this_machine_name[ 1024 ];

   ::ZeroMemory( this_machine_name, sizeof( this_machine_name ) );

   DWORD temp_dword = 1024;

   if ( ::GetComputerName( this_machine_name, &temp_dword ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't GetComputerName" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   // Something changed in service pack 3 for NT 3.51. You used to be able
   // to specify the local machine name and get SE_REMOTE_SHUTDOWN privilege
   // and shut down the machine. Not any more. You can no longer remotely
   // shut down your local machine. And no, I couldn't find this documented
   // anywhere...

   if ( m_MachineName.CompareNoCase( this_machine_name ) == 0 )
   {
      machine_name = NULL;
   }

   if ( machine_name != NULL )
   {
      // Shutdown a machine somewhere on the network

      if ( ::LookupPrivilegeValue( m_MachineName, SE_REMOTE_SHUTDOWN_NAME, &token_privileges.Privileges[ 0 ].Luid ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilegeValue for remote machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }
   }
   else
   {
      // Shutdown this computer

      if ( ::LookupPrivilegeValue( NULL, SE_SHUTDOWN_NAME, &token_privileges.Privileges[ 0 ].Luid ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilege for local machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }
   }

   token_privileges.PrivilegeCount             = 1;
   token_privileges.Privileges[ 0 ].Attributes = SE_PRIVILEGE_ENABLED;

   if ( ::AdjustTokenPrivileges( token_handle, FALSE, &token_privileges, 0, (PTOKEN_PRIVILEGES) NULL, 0 ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't AdjustTokenPrivileges" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   wfc_close_handle( token_handle );

   if ( machine_name != NULL )
   {
      // AbortSystemShutdown() is not const correct
      // The first parameter of AbortSystemShutdown() is a LPTSTR when it should be 
      // a LPCTSTR (const). Because it ain't, we gotta code around it.

      _tcscpy( this_machine_name, (LPCTSTR) m_MachineName );

      if ( ::AbortSystemShutdown( this_machine_name ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't AbortSystemShutdown on remote machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }
   }
   else
   {
      if ( ::AbortSystemShutdown( NULL ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't AbortSystemShutdown on local machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }
   }

   return( TRUE );
}

void CNetwork::Close( void )
{
   WFCLTRACEINIT( TEXT( "CNetwork::Close()" ) );

   if ( m_WideMachineName != NULL )
   {
      WFCTRACE( TEXT( "Deleting wide machine name" ) );
      delete [] m_WideMachineName;
      m_WideMachineName = NULL;
   }

   if ( m_WideDoubleBackslashPreceededMachineName != NULL )
   {
      WFCTRACE( TEXT( "Deleting wide double backslash preceeded machine name" ) );
      delete [] m_WideDoubleBackslashPreceededMachineName;
      m_WideDoubleBackslashPreceededMachineName = NULL;
   }

   if ( m_PortBuffer != NULL )
   {
      WFCTRACE( TEXT( "Deleting port array" ) );
      delete [] m_PortBuffer;
      m_PortBuffer = NULL;
   }

   m_MachineName.Empty();
   m_FriendlyMachineName.Empty();
   m_PortNumber    = 0;
   m_NumberOfPorts = 0;
}

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

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

   dump_context << TEXT( "m_MachineName         = \"" ) << m_MachineName         << TEXT( "\"\n" );
   dump_context << TEXT( "m_FriendlyMachineName = \"" ) << m_FriendlyMachineName << TEXT( "\"\n" );
   dump_context << TEXT( "m_PortNumber          = "   ) << m_PortNumber          << TEXT( "\n"   );
   dump_context << TEXT( "m_NumberOfPorts       = "   ) << m_NumberOfPorts       << TEXT( "\n"   );
   dump_context << TEXT( "m_ErrorCode           = "   ) << m_ErrorCode           << TEXT( "\n"   );
}

#endif // _DEBUG

BOOL CNetwork::EnumeratePorts( void )
{
   WFCLTRACEINIT( TEXT( "CNetwork::EnumeratePorts()" ) );

   m_PortNumber = 0;

   if ( m_PortBuffer != NULL )
   {
      WFCTRACE( TEXT( "Clearing data from previous call" ) );
      delete [] m_PortBuffer;
      m_PortBuffer    = NULL;
      m_NumberOfPorts = 0;
   }

   // First, we call EnumPorts to find out how big our buffer needs to be...

   DWORD number_of_bytes_needed = 0;

   BYTE pseudo_buffer[ 10 ];

   BOOL return_value = FALSE;

   // EnumPorts is not const correct, therefore we have to code around it...

   TCHAR machine_name[ MAX_PATH ];

   ::ZeroMemory( machine_name, sizeof( machine_name ) );

   _tcscpy( machine_name, CString( m_WideDoubleBackslashPreceededMachineName ) );

   return_value = ::EnumPorts( machine_name,
                               1,
                               pseudo_buffer,
                               sizeof( pseudo_buffer ),
                              &number_of_bytes_needed,
                              &m_NumberOfPorts );

   m_ErrorCode = ::GetLastError();

   if ( return_value != FALSE )
   {
      WFCTRACE( TEXT( "Something is bad wrong." ) );
      WFCTRACEERROR( m_ErrorCode );
      // Something bad wrong here...

      return( FALSE );
   }

   if ( m_ErrorCode != ERROR_INSUFFICIENT_BUFFER )
   {
      WFCTRACEVAL( TEXT( "Unexpected error at line " ), __LINE__ );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   WFCTRACEVAL( TEXT( "Allocating a buffer of size " ), number_of_bytes_needed );

   try
   {
      m_PortBuffer = new BYTE[ number_of_bytes_needed ];
   }
   catch( ... )
   {
      m_PortBuffer = NULL;
   }

   if ( m_PortBuffer == NULL )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't get memory for new data buffer" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   return_value = ::EnumPorts( machine_name,
                               1,
                               m_PortBuffer,
                               number_of_bytes_needed,
                              &number_of_bytes_needed,
                              &m_NumberOfPorts );

   if ( return_value == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't enumerate ports" ) );
      WFCTRACEERROR( m_ErrorCode );
      delete [] m_PortBuffer;
      m_PortBuffer    = NULL;
      m_NumberOfPorts = 0;
   }
   else
   {
      return_value = TRUE;
   }

   return( return_value );
}

BOOL CNetwork::GetNext( CPortInformation& port )
{
   WFCLTRACEINIT( TEXT( "CNetwork::GetNext( CPortInformation& )" ) );

   if ( m_PortBuffer == NULL )
   {
      WFCTRACE( TEXT( "You didn't call EnumeratePorts yet" ) );
      return( FALSE );
   }

   if ( m_PortNumber < m_NumberOfPorts )
   {
      PORT_INFO_1 *port_p = (PORT_INFO_1 *) m_PortBuffer;

      port.Copy( (PORT_INFO_1 *) &port_p[ m_PortNumber ] );
      m_PortNumber++;
      return( TRUE );
   }
   else
   {
      // We've retrieved the last one so clean up...

      delete [] m_PortBuffer;
      m_PortBuffer    = NULL;
      m_PortNumber    = 0;
      m_NumberOfPorts = 0;
      return( FALSE );
   }
}

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

void CNetwork::GetFriendlyMachineName( CString& machine_name ) const
{
   machine_name = m_FriendlyMachineName;
}

LPCTSTR CNetwork::GetMachineName( void )
{
   WFCLTRACEINIT( TEXT( "CNetwork::GetMachineName()" ) );
   return( (LPCTSTR) m_MachineName );
}

BOOL CNetwork::GetTime( CTime& machine_time )
{
   WFCLTRACEINIT( TEXT( "CNetwork::GetTime( CTime )" ) );

   TIME_OF_DAY_INFO * time_of_day = NULL;

   if ( ::NetRemoteTOD( m_WideMachineName, (LPBYTE *) &time_of_day ) == NERR_Success )
   {
      machine_time = CTime( time_of_day->tod_elapsedt );
      return( TRUE );
   }
   else
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }
}

BOOL CNetwork::GetTime( CSystemTime& machine_time )
{
   WFCLTRACEINIT( TEXT( "CNetwork::GetTime( CSystemTime )" ) );

   TIME_OF_DAY_INFO * time_of_day = NULL;

   if ( ::NetRemoteTOD( m_WideMachineName, (LPBYTE *) &time_of_day ) == NERR_Success )
   {
      machine_time.Copy( time_of_day );
      return( TRUE );
   }
   else
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }
}

BOOL CNetwork::IsRebootable( void )
{
   WFCLTRACEINIT( TEXT( "CNetwork::IsRebootable()" ) );

   HANDLE token_handle = NULL;

   if ( ::OpenProcessToken( ::GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &token_handle ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't OpenProcessToken" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   TOKEN_PRIVILEGES token_privileges;

   ::ZeroMemory( &token_privileges, sizeof( token_privileges ) );

   LPCSTR machine_name = NULL;

   // Check to see if we've opened ourselves...

   TCHAR this_machine_name[ 1024 ];

   ::ZeroMemory( this_machine_name, sizeof( this_machine_name ) );

   DWORD temp_dword = 1024;

   if ( ::GetComputerName( this_machine_name, &temp_dword ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't GetComputerName" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   // Something changed in service pack 3 for NT 3.51. You used to be able
   // to specify the local machine name and get SE_REMOTE_SHUTDOWN privilege
   // and shut down the machine. Not any more. You can no longer remotely
   // shut down your local machine. And no, I couldn't find this documented
   // anywhere...

   if ( m_MachineName.CompareNoCase( this_machine_name ) == 0 )
   {
      machine_name = NULL;
   }

   if ( machine_name != NULL )
   {
      // Shutdown a machine somewhere on the network

      if ( ::LookupPrivilegeValue( m_MachineName, SE_REMOTE_SHUTDOWN_NAME, &token_privileges.Privileges[ 0 ].Luid ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilegeValue for remote machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }
   }
   else
   {
      // Shutdown this computer

      if ( ::LookupPrivilegeValue( NULL, SE_SHUTDOWN_NAME, &token_privileges.Privileges[ 0 ].Luid ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilegeValue for local machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }
   }

   token_privileges.PrivilegeCount             = 1;
   token_privileges.Privileges[ 0 ].Attributes = SE_PRIVILEGE_ENABLED;

   if ( ::AdjustTokenPrivileges( token_handle, FALSE, &token_privileges, 0, (PTOKEN_PRIVILEGES) NULL, 0 ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't AdjustTokenPrivileges" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   // If we get this far it means we can reboot the machine...

   return( TRUE );
}

void CNetwork::m_Initialize( void )
{
   WFCLTRACEINIT( TEXT( "CNetwork::m_Initialize()" ) );
   m_MachineName.Empty();
   m_FriendlyMachineName.Empty();
   m_WideMachineName = NULL;
   m_WideDoubleBackslashPreceededMachineName = NULL;
   m_ErrorCode       = 0;
   m_PortBuffer      = NULL;
   m_NumberOfPorts   = 0;
   m_PortNumber      = 0;
}

void CNetwork::Open( LPCTSTR machine_name )
{
   WFCLTRACEINIT( TEXT( "CNetwork::Open()" ) );

   // First, make sure we're closed...

   Close();

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

   try
   {
      if ( machine_name != NULL )
      {
         // Thanks go to Ullrich Pollahne (u.pollaehne@online.de)
         // for finding a bug here. I was not correctly counting
         // the number of bytes needed for a buffer.

         int additional_characters = 1; // For the 0x00 at the end

         CString temporary_machine_name( machine_name );

         WFCTRACEVAL( TEXT( "Opening " ), temporary_machine_name );

         // Strip off the \\ if present

         if ( temporary_machine_name.GetLength() > 1 )
         {
            if ( temporary_machine_name.GetAt( 0 ) == TEXT( '\\' ) )
            {
               temporary_machine_name = temporary_machine_name.Right( temporary_machine_name.GetLength() - 1 );
               additional_characters++;
            }

            if ( temporary_machine_name.GetAt( 0 ) == TEXT( '\\' ) )
            {
               temporary_machine_name = temporary_machine_name.Right( temporary_machine_name.GetLength() - 1 );
               additional_characters++;
            }
         }

         // We now have a backslash-free name

         m_FriendlyMachineName = temporary_machine_name;

         try
         {
            m_WideMachineName = new WCHAR[ temporary_machine_name.GetLength() + additional_characters ];
         }
         catch( ... )
         {
            m_WideMachineName = NULL;
         }

         if ( m_WideMachineName != NULL )
         {
#if defined( UNICODE )
            ::_tcscpy( m_WideMachineName, machine_name );
#else
            ::ASCII_to_UNICODE( machine_name, m_WideMachineName );
#endif
         }

         m_MachineName = machine_name;

         // Now, add those stinking backslashes

         temporary_machine_name  = TEXT( "\\\\" );
         temporary_machine_name += m_FriendlyMachineName;

         try
         {
            m_WideDoubleBackslashPreceededMachineName = new WCHAR[ temporary_machine_name.GetLength() + 1 ];
         }
         catch( ... )
         {
            m_WideDoubleBackslashPreceededMachineName = NULL;
         }

         if ( m_WideDoubleBackslashPreceededMachineName != NULL )
         {
#if defined( UNICODE )
            ::_tcscpy( m_WideDoubleBackslashPreceededMachineName, temporary_machine_name );
#else
            ::ASCII_to_UNICODE( temporary_machine_name, m_WideDoubleBackslashPreceededMachineName );
#endif
         }
      }
      else
      {
         // The machine name is NULL, that means the user wants to play
         // with the local machine. That's OK, all we need to do is put
         // the name of the computer into m_FriendlyName

         TCHAR this_machine_name[ MAX_COMPUTERNAME_LENGTH + 1 ];

         DWORD string_size = MAX_COMPUTERNAME_LENGTH + 1;

         ZeroMemory( this_machine_name, sizeof( this_machine_name ) );

         if ( ::GetComputerName( this_machine_name, &string_size ) == FALSE )
         {
            // CRAP! The computer name is too long.

            TCHAR * new_string = new TCHAR[ string_size + 1 ];

            string_size++;

            if ( ::GetComputerName( new_string, &string_size ) == FALSE )
            {
               // DOUBLE CRAP!
               return;
            }

            m_FriendlyMachineName = new_string;

            delete [] new_string;
         }
         else
         {
            m_FriendlyMachineName = this_machine_name;
         }
      }
   }
   catch( ... )
   {
      m_Initialize();
   }
}

#if ! defined(  WFC_NO_SERIALIZATION )

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

   CObject::Serialize( archive );

   if ( archive.IsStoring() )
   {
      WFCTRACE( TEXT( "Storing" ) );
      archive << m_MachineName;
      archive << m_ErrorCode;
   }
   else
   {
      WFCTRACE( TEXT( "Restoring" ) );
      CString temp_string;
      archive >> temp_string;
      archive >> m_ErrorCode;
      Open( temp_string );
   }
}

#endif // WFC_NO_SERIALIZATION

BOOL CNetwork::SetPrivilege( LPCTSTR privilege_name, BOOL add_privilege )
{
   WFCLTRACEINIT( TEXT( "CNetwork::SetPrivilege()" ) );

   HANDLE token_handle = NULL;

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

   try
   {
      if ( ::OpenProcessToken( ::GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &token_handle ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't OpenProcessToken" ) );
         WFCTRACEERROR( m_ErrorCode );
         return( FALSE );
      }

      TOKEN_PRIVILEGES token_privileges;
      TOKEN_PRIVILEGES previous_token_privileges;

      LUID locally_unique_identifier;

      ::ZeroMemory( &token_privileges, sizeof( token_privileges ) );
      ::ZeroMemory( &previous_token_privileges, sizeof( previous_token_privileges ) );
      ::ZeroMemory( &locally_unique_identifier, sizeof( locally_unique_identifier ) );
   
      if ( ::LookupPrivilegeValue( m_MachineName, privilege_name, &locally_unique_identifier ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilegeValue for remote machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         ::wfc_close_handle( token_handle );
         token_handle = NULL;
         return( FALSE );
      }

      token_privileges.PrivilegeCount             = 1;
      token_privileges.Privileges[ 0 ].Luid       = locally_unique_identifier;
      token_privileges.Privileges[ 0 ].Attributes = 0;

      DWORD sizeof_previous_token_privileges = sizeof( previous_token_privileges );

      if ( ::AdjustTokenPrivileges( token_handle, 
                                    FALSE, 
                                   &token_privileges, 
                                    sizeof( token_privileges ),
                                   &previous_token_privileges,
                                   &sizeof_previous_token_privileges ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't AdjustTokenPrivileges" ) );
         WFCTRACEERROR( m_ErrorCode );
         ::wfc_close_handle( token_handle );
         token_handle = NULL;
         return( FALSE );
      }

      previous_token_privileges.PrivilegeCount       = 1;
      previous_token_privileges.Privileges[ 0 ].Luid = locally_unique_identifier;
      
      if ( add_privilege != FALSE )
      {
         previous_token_privileges.Privileges[ 0 ].Attributes |= (SE_PRIVILEGE_ENABLED);
      }
      else
      {
         previous_token_privileges.Privileges[ 0 ].Attributes ^= ( (SE_PRIVILEGE_ENABLED) & previous_token_privileges.Privileges[ 0 ].Attributes );
      }

      if ( ::AdjustTokenPrivileges( token_handle, 
                                    FALSE, 
                                   &previous_token_privileges, 
                                    sizeof_previous_token_privileges,
                                    NULL,
                                    NULL ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't AdjustTokenPrivileges for the second time" ) );
         WFCTRACEERROR( m_ErrorCode );
         ::wfc_close_handle( token_handle );
         token_handle = NULL;
         return( FALSE );
      }

      // YIPPEE! We succeeded!

      ::wfc_close_handle( token_handle );
      token_handle = NULL;

      return( TRUE );
   }
   catch( ... )
   {
      // Let the caller know an exception occurred
      m_ErrorCode = ERROR_EXCEPTION_IN_SERVICE;
      return( FALSE );
   }
}

BOOL CNetwork::Shutdown( BOOL reboot, BOOL force_applications_to_close, LPCTSTR message_to_display, DWORD number_of_seconds_before_shutdown )
{
   WFCLTRACEINIT( TEXT( "CNetwork::Shutdown()" ) );

   HANDLE token_handle = NULL;

   if ( ::OpenProcessToken( ::GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &token_handle ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't OpenProcessToken" ) );
      WFCTRACEERROR( m_ErrorCode );
      return( FALSE );
   }

   TOKEN_PRIVILEGES token_privileges;

   ::ZeroMemory( &token_privileges, sizeof( token_privileges ) );

   // 1999-11-12
   // Thanks go to Karl Spaelti (karl.spaelti@qps.ch) for finding a bug
   // here. machine_name was a LPCSTR when it should have been LPCTSTR.

   LPCTSTR machine_name = NULL;

   // Check to see if we've opened ourselves...

   TCHAR this_machine_name[ 1024 ];

   ::ZeroMemory( this_machine_name, sizeof( this_machine_name ) );

   DWORD temp_dword = 1024;

   if ( ::GetComputerName( this_machine_name, &temp_dword ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't GetComputerName" ) );
      WFCTRACEERROR( m_ErrorCode );
      ::wfc_close_handle( token_handle );
      token_handle = NULL;
      return( FALSE );
   }

   // Something changed in service pack 3 for NT 3.51. You used to be able
   // to specify the local machine name and get SE_REMOTE_SHUTDOWN privilege
   // and shut down the machine. Not any more. You can no longer remotely
   // shut down your local machine. And no, I couldn't find this documented
   // anywhere...

   if ( m_MachineName.CompareNoCase( this_machine_name ) == 0 )
   {
      machine_name = NULL;
   }
   else
   {
      machine_name = (LPCTSTR) m_MachineName;
   }

   if ( machine_name != NULL )
   {
      // Shutdown a machine somewhere on the network

      if ( ::LookupPrivilegeValue( m_MachineName, SE_REMOTE_SHUTDOWN_NAME, &token_privileges.Privileges[ 0 ].Luid ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilegeValue for remote machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         ::wfc_close_handle( token_handle );
         token_handle = NULL;
         return( FALSE );
      }
   }
   else
   {
      // Shutdown this computer

      if ( ::LookupPrivilegeValue( NULL, SE_SHUTDOWN_NAME, &token_privileges.Privileges[ 0 ].Luid ) == FALSE )
      {
         m_ErrorCode = ::GetLastError();
         WFCTRACE( TEXT( "Can't LookupPrivilegeValue for local machine" ) );
         WFCTRACEERROR( m_ErrorCode );
         ::wfc_close_handle( token_handle );
         token_handle = NULL;
         return( FALSE );
      }
   }

   token_privileges.PrivilegeCount             = 1;
   token_privileges.Privileges[ 0 ].Attributes = SE_PRIVILEGE_ENABLED;

   if ( ::AdjustTokenPrivileges( token_handle, FALSE, &token_privileges, 0, (PTOKEN_PRIVILEGES) NULL, 0 ) == FALSE )
   {
      m_ErrorCode = ::GetLastError();
      WFCTRACE( TEXT( "Can't AdjustTokenPrivileges" ) );
      WFCTRACEERROR( m_ErrorCode );
      ::wfc_close_handle( token_handle );
      token_handle = NULL;
      return( FALSE );
   }

   // Whoever wrote InitiateSystemShutdown() (nor the QA/tester) didn't understand the
   // concept of const pointers. The way InitiateSystemShutdown() is prototyped, one
   // would expect it to be returning strings from the operating system. It doesn't
   // (or if it does it isn't documented but Microsoft would never ever ever not
   // document an API parameter) return any data in the string parameters. So, we are
   // left with either a programmer that didn't fully understand what they were doing
   // or it is yet another undocumented feature of the system.

   // InitiateSystemShutdown() is not const correct.
   // The second parameter of InitiateSystemShutdown() is a LPTSTR when it should be
   // a LPCTSTR (const). Because it ain't, we gotta code around it.

   TCHAR message_string[ 1024 ];

   ::ZeroMemory( message_string, sizeof( message_string ) );

   LPTSTR corrected_message_parameter = NULL;

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

   try
   {
      if ( message_to_display != NULL )
      {
         _tcsncpy( message_string, message_to_display, 1023 );
         corrected_message_parameter = message_string;
      }
      else
      {
         corrected_message_parameter = NULL;
      }

      if ( machine_name != NULL )
      {
         // The first parameter of InitiateSystemShutdown() is a LPTSTR when it should be 
         // a LPCTSTR (const). Because it ain't, we gotta code around it.

         _tcscpy( this_machine_name, (LPCTSTR) m_MachineName );

         if ( ::InitiateSystemShutdown( this_machine_name, corrected_message_parameter, number_of_seconds_before_shutdown, force_applications_to_close, reboot ) == FALSE )
         {
            m_ErrorCode = ::GetLastError();
            WFCTRACE( TEXT( "Can't InitiateSystemShutdown for remote machine" ) );
            WFCTRACEERROR( m_ErrorCode );
            ::wfc_close_handle( token_handle );
            token_handle = NULL;
            return( FALSE );
         }
      }
      else
      {
         if ( ::InitiateSystemShutdown( NULL, corrected_message_parameter, number_of_seconds_before_shutdown, force_applications_to_close, reboot ) == FALSE )
         {
            m_ErrorCode = ::GetLastError();
            WFCTRACE( TEXT( "Can't InitiateSystemShutdown for local machine" ) );
            WFCTRACEERROR( m_ErrorCode );
            ::wfc_close_handle( token_handle );
            token_handle = NULL;
            return( FALSE );
         }
      }

      ::wfc_close_handle( token_handle );
      token_handle = NULL;
      return( TRUE );
   }
   catch( ... )
   {
      m_ErrorCode = ERROR_EXCEPTION_IN_SERVICE;
      ::wfc_close_handle( token_handle );
      token_handle = NULL;
      return( FALSE );
   }
}

// End of source

#if 0
<HTML>

<HEAD>
<TITLE>WFC - CNetwork</TITLE>
<META name="keywords" content="WFC, MFC extension library, freeware class library, Win32, source code">
<META name="description" content="The C++ base class for the networking classes.">
</HEAD>

<BODY>
<H1>CNetwork : CObject</H1>
$Revision: 41 $<BR><HR>

<H2>Description</H2>
This class is the base class for the WFC networking classes. It is not a pure
virtual base class in that it provides some interesting (and hopefully
useful) functions.

<H2>Constructors</H2>

<DL COMPACT>

<DT><PRE><B>CNetwork</B>( LPCTSTR machine_name = NULL )</PRE><DD>
Constructs the object.

</DL>

<H2>Data Members</H2>None.

<H2>Methods</H2>

<DL COMPACT>

<DT><PRE>BOOL <B>AbortShutdown</B>( void )</PRE><DD>
Will abort a shutdown started by <B>Shutdown</B>().

<DT><PRE>void <B>Close</B>( void )</PRE><DD>
Closes the connection to the machine.

<DT><PRE>BOOL <B>EnumeratePorts</B>( void )</PRE><DD>
Prepares to enumerate the ports on the machine.

<DT><PRE>DWORD <B>GetErrorCode</B>( void ) const</PRE><DD>
Retrieves the error code. This is set when a
member function returns FALSE.

<DT><PRE>void <B>GetFriendlyMachineName</B>( CString&amp; machine_name )</PRE><DD>
Fills <CODE>machine_name</CODE> with the name of the machine
that has been <B>Open</B>()'ed. This names doesn't have those
annoying backslashes preceeding it.

<DT><PRE>LPCTSTR <B>GetMachineName</B>( void )</PRE><DD>
Retrieves the name of the machine this class
is working with.

<DT><PRE>BOOL <B>GetNext</B>( <A HREF="PortInformation.htm">CPortInformation</A>&amp; port_information )</PRE><DD>
Gets the next <B><A HREF="PortInformation.htm">CPortInformation</A></B> (used in conjunction with
<B>EnumeratePorts</B>()).

<DT><PRE>BOOL <B>GetTime</B>( CTime&amp; time )
BOOL <B>GetTime</B>( <A HREF="CSystemTime.htm">CSystemTime</A>&amp; time )</PRE><DD>
Gets the time from the machine as a CTime or a 
<A HREF="CSystemTime.htm">CSystemTime</A> (more accurate).

<DT><PRE>BOOL <B>IsRebootable</B>( void )</PRE><DD>
Returns TRUE if you have permissions to reboot the machine.
In other words, a call to <B>Shutdown</B>() should succeed.

<DT><PRE>void <B>Open</B>( LPCTSTR machine_name = NULL )</PRE><DD>
Tells the class to work with the machine you specify.

<DT><PRE>void <B>Serialize</B>( CArchive&amp; archive )</PRE><DD>
After all we are a CObject...

<DT><PRE>BOOL <B>SetPrivilege</B>( LPCTSTR privilege_name, BOOL add_privilege = TRUE )</PRE><DD>
Adds or removes a privilege. If <CODE>add_privilege</CODE> is FALSE, the 
privilege is removed, otherwise it is added. <CODE>privilege_name</CODE>
can be one of the following (as of NT4.0SP2/VC42b):

<UL>
<LI>SE_CREATE_TOKEN_NAME
<LI>SE_ASSIGNPRIMARYTOKEN_NAME
<LI>SE_LOCK_MEMORY_NAME
<LI>SE_INCREASE_QUOTA_NAME
<LI>SE_UNSOLICITED_INPUT_NAME
<LI>SE_MACHINE_ACCOUNT_NAME
<LI>SE_TCB_NAME
<LI>SE_SECURITY_NAME
<LI>SE_TAKE_OWNERSHIP_NAME
<LI>SE_LOAD_DRIVER_NAME
<LI>SE_SYSTEM_PROFILE_NAME
<LI>SE_SYSTEMTIME_NAME
<LI>SE_PROF_SINGLE_PROCESS_NAME
<LI>SE_INC_BASE_PRIORITY_NAME
<LI>SE_CREATE_PAGEFILE_NAME
<LI>SE_CREATE_PERMANENT_NAME
<LI>SE_BACKUP_NAME
<LI>SE_RESTORE_NAME
<LI>SE_SHUTDOWN_NAME
<LI>SE_DEBUG_NAME
<LI>SE_AUDIT_NAME
<LI>SE_SYSTEM_ENVIRONMENT_NAME
<LI>SE_CHANGE_NOTIFY_NAME
<LI>SE_REMOTE_SHUTDOWN_NAME
</UL>

<DT><PRE>BOOL <B>Shutdown</B>( BOOL    reboot                            = TRUE,
               BOOL    force_applocations_to_close       = TRUE,
               LPCTSTR message_to_display                = NULL,
               DWORD   number_of_seconds_before_shutdown = 0 )</PRE><DD>
Will reboot the machine set by <B>Open</B>().

</DL>

<H2>Example</H2><PRE><CODE>void test_CNetwork( LPCTSTR machine_name )
{
   <A HREF="WfcTrace.htm">WFCTRACEINIT</A>( TEXT( &quot;test_CNetwork()&quot; ) );

   <B>CNetwork</B> machine( machine_name );

   if ( machine.EnumeratePorts() )
   {
      if ( machine_name != NULL )
      {
         _tprintf( TEXT( &quot;Ports on %s\n&quot; ), machine_name );
      }
      else
      {
         _tprintf( TEXT( &quot;Ports on local machine\n&quot; ) );
      }

      <A HREF="PortInformation.htm">CPortInformation</A> port;

      while( machine.GetNext( port ) )
      {
         _tprintf( TEXT( &quot;Name:        %s\n&quot; ), (LPCTSTR) port.Name        );
         _tprintf( TEXT( &quot;Monitor:     %s\n&quot; ), (LPCTSTR) port.Monitor     );
         _tprintf( TEXT( &quot;Description: %s\n&quot; ), (LPCTSTR) port.Description );
         _tprintf( TEXT( &quot;Type:        %04lX\n&quot; ), port.Type );
         _tprintf( TEXT( &quot;TypeName:    %s\n\n&quot; ), (LPCTSTR) port.TypeName );
      }
   }
   else
   {
      DWORD error_code = machine.GetErrorCode();
      ReportError( error_code );
      _tprintf( TEXT( &quot;Can't EnumeratePorts, reason code %lu\n&quot; ), error_code );
   }

   if ( machine.IsRebootable() )
   {
      if ( machine_name != NULL )
      {
         _tprintf( TEXT( &quot;Yes, I can reboot %s\n&quot; ), machine_name );
      }
      else
      {
         _tprintf( TEXT( &quot;Yes, I can reboot this machine\n&quot; ) );
      }
   }
}</CODE></PRE>

<H2>API's Used</H2>

<UL>
<LI>AbortSystemShutdown
<LI>AdjustTokenPrivileges
<LI>EnumPorts
<LI>GetComputerName
<LI>GetCurrentProcess
<LI>GetLastError
<LI>InitiateSystemShutdown
<LI>LookupPrivilegeValue
<LI>NetRemoteTOD
<LI>OpenProcessToken
<LI>ZeroMemory
</UL>

<HR><I>Copyright, 2000, <A HREF="mailto:wfc@pobox.com">Samuel R. Blackburn</A></I><BR>
$Workfile: cnetwork.cpp $<BR>
$Modtime: 5/02/00 6:03p $
</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