README.TXT

File Parser 
 
 
SUMMARY 
======= 
 
The FPARSER sample parses files with a particular extension. 
 
The default file extension for this sample is TST. To use this file parser  
for ASCII files of different extensions, the registry must be changed. The  
registry entry for the new extension must be given a new key named  
QuickViewAddOn under the subkey that contains our viewer class identifier.  
Within this key, the registry should have an item named DllName, whose value  
is the name of your DLL. 
 
As an example, a filter whose file extension is .XXX, would need the 
following reg file contents merged into the registry: 
 
   HKEY_LOCAL_MACHINE\SOFTWARE\ 
   Classes\QuickView\.XXX\{F0F08735-0C36-101B-B086-0020AF07D0F4} 
   \QuickViewAddOn 
 
   DllName"="vsxxx.dll 
 
This would enable a user to right-click on a file of extension .XXX and 
have the vsxxx.dll file parser be used. 
 
This approach will override any built-in file identification used by 
SCC's DLLs, using the extension only to choose the specified file parser. 
 
NOTE: No other identifier can be used in the above registry entry. 
 
MORE INFORMATION 
================ 
 
This sample provides a template for an ASCII file parser. It is configured 
to work with the file extension .TST, but this can be changed by modifying 
FPARSER.REG to the extension you wish. 
 
Usage 
----- 
 
To use this file parser, use the following steps: 
 
1. Import FPARSER.REG into your registry. 
 
2. Set the key HKEY_LOCAL_MACHINE\SOFTWARE\SCC\Viewer Technology\MS1.  
   Verify to a non-zero value. This will reset the list of parsers the next  
   time a file is viewed. 
 
3. Build VS_ASC.DLL. 
 
4. Copy VS_ASC.DLL to <windows path>\SYSTEM\VIEWERS. 
 
5. Rename or copy an ASCII file to a .TST extension. 
 
6. From the Explorer, right-click the file. 
 
7. Select Quick View.