home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / sysmgmt / setup / infinst / readme.txt < prev    next >
Text File  |  1996-06-22  |  2KB  |  34 lines
  1. The InfInst sample demonstrates the basic use of the Win32 Setup APIs.
  2.  
  3. Win32 Setup APIs are a series of functions for installing files, 
  4. modifying the registry, and modifying INI files.  The primary way
  5. to use the Win32 Setup APIs is to combine the INF handling functions
  6. with one or more INF files that describe the actions to perform 
  7. during your install or uninstall.  One benefit of the Win32 Setup APIs
  8. is that it provides dialog boxes that are consistent, familiar to user 
  9. from the NT and Windows 95 setup, and localized if the OS is 
  10. localized.  Moreover, the copy operations can handle things like
  11. version checking and replacing in use files.  See the thorough 
  12. documentation in the Win32 SDK help.  
  13.  
  14. Below are the primary APIs used in this sample. These are implemented
  15. in the doinst.c file.  The rest of the sample is a basic wizard 
  16. that collects simple information from the user. The wizard is based
  17. on the win32\wizard sample and is not complete in its error handling
  18. and in helping the user determine things like disks space.
  19.  
  20. The install process overview is:
  21.   TASK                       SETUPAPI
  22.   open a specific inf        SetupOpenInfFile
  23.   call the wizard for input  (CreateWizard implement in the sample)
  24.   set the directory ids      SetupSetDirectoryId
  25.   create a file queue        SetupOpenFileQueue
  26.   create a queue context     SetupInitDefaultQueueCallback
  27.   add files to queue         SetupInstallFilesFromInfSection
  28.   do the copy                SetupCommitFileQueue
  29.   do the registry stuff      SetupInstallFromInfSection
  30.   close the queue            SetupTermDefaultQueueCallback
  31.   close the inf              SetupCloseFileQueue
  32.  
  33. Many of the Win32 Setup APIs are specific to device driver
  34. installations which are not addressed in this sample.