home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / utils / pt04bp22 / reguser.txt < prev    next >
Encoding:
Text File  |  1995-05-19  |  4.9 KB  |  131 lines
  1.  
  2.  
  3.                                 R E G U S E R
  4.  
  5.                                     v1.0
  6.  
  7.  
  8.  
  9. DISCLAIMER:
  10. ===========
  11.  
  12. This utility mucks with the registry and as such can do great harm to your NT
  13. setup if not used with care, perhaps even rendering your system unbootable.
  14. While I have made every attempt to verify the correct operation of this
  15. utility, I will not accept any responsibility for damages done to your
  16. hardware, software, or phyche as the result of using this utility or software
  17. based on this utility -- the user will accept all responsibility for any
  18. undesirable effects of this utility. Fair enough? If not, remove this utility
  19. from your system.
  20.  
  21.  
  22. Why So Serious?
  23. ===============
  24.  
  25. The disclaimer above is so serious because the registry is to NT what our
  26. long term memory is to us. If you twiddle the wrong bits in either one, you
  27. could do serious damage. So please, becareful with this utility.
  28.  
  29.  
  30. What's It For?
  31. ==============
  32.  
  33. As the author of PTerm, I came to a point when I decided to add the ability
  34. for PTerm to play a wav file when finished uploading or downloading. At first
  35. I was going to design a dialog box which the user could pop up to set the
  36. sounds s/he wanted played. Then one day I was in the control panel 'Sound'
  37. applet when I noticed that there were two application entries which the user
  38. could set sounds for (in addition to the system sound entries), one for MS
  39. Mail and one for Schedule+.
  40.  
  41. I started thinking that it would be nice if I could add a couple of fairly
  42. generic entries in there for PTerm, one for a completed download, and one for
  43. a completed upload. I looked in the registry for where the list of sounds
  44. were kept and figured out the format. I then went looking for a small utility
  45. which I could place in a batch file to automatically add the new entries in a
  46. users registry -- there were none, at least none which I could figure out how
  47. to use.
  48.  
  49. I didn't want to leave the user to starting up REGEDT32 and mucking around
  50. with that, so I wrote Reguser. Its called RegUSER because it can only be used
  51. to add/change registry values in the HKEY_CURRENT_USER tree.
  52.  
  53.  
  54. Operation
  55. =========
  56.  
  57. Since we have been talking about its use for PTerm, I will continue with that
  58. line of thought and use it as the example.
  59.  
  60. Ok, we see that in the HKEY_CURRENT_USER tree there is a path to the sounds
  61. called:
  62.  
  63.    Control Panel\Sounds
  64.  
  65. We would like to add a couple of values to this key, one called
  66. AppDownloadCompleted and AppUploadCompleted. The format of these values is
  67. REG_SZ, which means they are zero terminated strings. This brings up an
  68. important limitation of Reguser -- it can only add/modify values of type
  69. REG_SZ. If you try and change a value which is not REG_SZ, changes are
  70. Reguser will change the type to REG_SZ and this will cause you grief. 
  71.  
  72. The exact format for a sound entry is:
  73.  
  74.    Control Panel\Sounds\SoundValueIdentifier = sound.wav,List Entry String
  75.  
  76. Lets look at an example, like the sound played when new MS Mail arrives:
  77.  
  78.    Control Panel\Sounds\MailBeep = ding.wav,New Mail Notification
  79.  
  80. Alright, "MailBeep" is the the identifier which MS Mail will use to retrieve
  81. the sound to play when new mail arrives. "ding.wav" is what the sound is
  82. currently set to. "New Mail Notification" is the string which shows up in the
  83. list box when the control panel "Sound" applet is run.
  84.  
  85. With that in mind, here are the command lines for adding the two values we
  86. need for PTerm's sound support, setting the sound to none for now:
  87.  
  88.   reguser "Control Panel\Sound" AppDownloadCompleted "<none>,Download Completed"
  89.   reguser "Control Panel\Sound" AppUploadComplete" "<none>,Upload Completed"
  90.  
  91. You can see that Reguser takes three parameters -- the path to the key for
  92. which a value is to be changed/added, the name of the value to add/change,
  93. and what to set the value to. Note that anytime one of the parameters needs
  94. special characters like spaces, angle brackets or commas, you must enclose
  95. the entire parameter in double quotes.
  96.  
  97. After executing these two commands the user can fire up Control Panel and
  98. open the Sound applet, and s/he will see in the list of available sounds to
  99. set both "Download Completed" and "Upload Completed" which they can change
  100. from "<none>" to be any sound on their system.
  101.  
  102. If Reguser is successful in adding/changing the value it will indicate as
  103. such, otherwise it will indicate an error.
  104.  
  105.  
  106. Source Code
  107. ===========
  108.  
  109. The source for this utility is included in RGUSRSRC.ZIP. If you make any
  110. enchancements to Reguser, please send me a copy, and try to retain backward
  111. compatibility if possible (i.e. keep the first 3 parameters the same for
  112. instance).
  113.  
  114.  
  115. Where Is Me?
  116. ============
  117.  
  118. I can be reached via email at:
  119.  
  120.    urjc!rjc@pcg.com
  121.    rjc@pcg.com
  122.    rjc@infograph.com
  123.    roncox@inidrect.com
  124.    71722.3175@compuserve.com
  125.  
  126. Feel free to email me anytime...
  127.  
  128. Have fun, and for cryin' out loud, becareful!
  129. Ron Cox
  130.  
  131.