Appendix A

Registry Entries

Registry Editor
Reading Hexadecimal Key Values
Microsoft Proxy Server Registry Entries

Microsoft Proxy Server services are configured using the Microsoft Proxy Server Setup program and Internet Service Manager.

All configuration values for Windows NT are stored in a database known as the registry. You can optionally use the Registry Editor (Regedt32.exe) to view, modify, or change these values directly.

Warning   Do not use Regedt32.exe as a substitute for Internet Service Manager. Values changed with Regedt32.exe will not be updated directly. You must stop and start the service to have them take effect. Changes made by using Internet Service Manager take effect immediately.

Registry Editor

The Registry Editor is an advanced tool that you can use to change settings in your system registry, which contains information about how your computer runs.

In most cases, the default settings for Microsoft Proxy Server registry values that are made during setup will be acceptable for most installations. Where a value can be modified, a recommended range of values has been offered. In some cases, you may be able to specify a value beyond what is recommended, but such attempts should be undertaken with caution.

If you decide to change registry values for any of the following registry keys, try to observe good administrative practices for doing so. Use the following guidelines to help in implementing your changes:

• Use Internet Service Manager if possible.

  Use the administrative tools in Internet Service Manager whenever possible. Edit registry values directly by using the Registry Editor only when it is not possible to set a value by using the Internet Service Manager.

• Limit the number of changes made at one time.

  When you make changes to some values in the registry, the effects can be dynamic. In some cases, a single value can interact with other values to create a larger total effect on service performance. If you are not certain about the effects of a specific value you are changing, be conservative in altering the current value. If you alter values beyond the recommended ranges, you should restart the service and monitor the effects closely before making any further changes.

Warning   You should not edit your registry unless it is absolutely necessary. Generally, it is best to use Windows controls to change your system settings. If you introduce an error in your registry, your computer may become nonfunctional.

To start the registry editor

1. Open an MS-DOS® command-prompt window.
2. Type regedt32.

The registry is organized as a directory tree. Registry entries are called keys and can contain values. Keys can be added, modified, or deleted by applications. Each value has a class, or data type.

For more information about editing the registry, see the online Help for Registry Editor, or see your documentation for Windows NT.

If you make changes to the registry that cause your computer to stop working properly, you can restore the registry settings to the last working configuration.

To restore the registry

1. Use the Start button to shut down your computer.

2. Restart in MS-DOS mode.

3. Change to your Windows NT directory system directory, Winnt.

4. Type the following commands:
   
   attrib -h -r -s system.dat
   attrib -h -r -s system.da0
   copy system.da0 system.dat
   attrib -h -r -s user.dat
   attrib -h -r -s user.da0
   copy user.da0 user.dat

5. Restart your computer.

Reading Hexadecimal Key Values

Numeric values and ranges listed in the following tables are expressed exactly as they appear in the registry. For some values that use the REG_DWORD data type, values can be expressed in either hexadecimal or binary form. For cases where the defined value represents a hexadecimal numeric, (h) is used to indicate that these are stated as hexadecimal values.

The following table shows an example of a default value and range of values expressed in hexadecimal notation:

Converting these same numbers to decimal equivalent values would indicate the following values :

Its important to keep these differences in mind when you apply changes. To assist you in applying changes to hexadecimal-stated key entries or interpreting the current values, you can use a scientific calculator, such as the Calculator application (Calc.exe) to make conversions between hexadecimal and decimal values where appropriate.

If you use Calculator, you will need to select View and click Scientific so that you can enter numbers in either hexadecimal or decimal format and then click the button to convert the numbers to either of these formats.

You can also select DWORD from the Edit menu in Registry Editor and click the buttons to change your view of a specific key value to binary, hexadecimal, or decimal notation. This can be useful when you are directly editing key values in the registry.

Microsoft Proxy Server Registry Entries

Domain Filtering Keys
Web Proxy Service Keys
Cache Keys
WinSock Proxy Service Keys
Other Keys Added for Microsoft Proxy Server

All default values are set during installation. Entries for Microsoft Proxy Server services are located in the following tree branches:

Domain Filtering Keys

The Microsoft Proxy Server domain filtering registry values are located in:

HKEY_LOCAL_MACHINE
  SYSTEM
     \CurrentControlSet
        \Services
            \W3Proxy
               \Parameters
                  \DoFilter

These filters apply to both WinSock Proxy and Web Proxy. The following values are available:

FilterType
NumDenySites
NumGrantSites

Examples of Domain Filtering

Domain filtering can be applied to either grant or deny access to all Internet sites by default, with specified site exceptions added individually.

Denying Access to Specified Sites

As an example, suppose you want to use Internet Service Manager to set a filter to deny access to two sites. The sites are Website1, whose domain is www.website1.com, and Website2, whose domain is www.website2.com.

You would first set the Filters property to Enable Filtering and the default access to Granted. For each site, you select Add and enter each site (www.website1.com, for example) you want to restrict access to by using the Deny Access To dialog box.

The registry would then be reconfigured as follows: FilterType is set to 1, the NumDenySites is set to 2, and a new subkey is created called DenySites. DenySites would be set to www.website1.com www.website2.com.

Granting Access for Specified Sites

In this example, suppose you want to use Internet Service Manager to set a filter to grant access only to a single specified site. The site is Website3, whose domain is www.website3.com.

You would first set the Filters property to Enable Filtering and the default access to Denied. This will deny access to all Internet sites except those sites which you choose to specifically allow access to. You can then grant Internet access to a single site, Website3, by clicking Add and typing www.website3.com in the Grant Access To dialog box.

The registry would then be reconfigured as follows: Filter Type is set to 2, the NumGrantSites is set to 1, and a new subkey called GrantSites is created. GrantSites would be set to www.website3.com.

Web Proxy Service Keys

The Web Proxy service registry values are located in:

HKEY_LOCAL_MACHINE
  SYSTEM
     \CurrentControlSet
        \Services
            \W3Proxy
               \Parameters
                 

The following values are available:

Setting RPC Bindings

The RpcBindings value uses a 3-bit submasking method to determine Remote Procedure Call (RPC) bindings for three supported protocols: TCP/IP, IPX/SPX, and NetBIOS. The use of a bit value 1 indicates that the protocol will be bound. The use of a bit value of 0 indicates the protocol will not be bound.

The following table shows corresponding decimal values for removing and adding bindings for each of the three supported protocols.

Cache Keys

Cache Parameters
Cache Path
Cache Filters

Cache Parameters

The Web Proxy Service cache registry values are located in:

HKEY_LOCAL_MACHINE
   SYSTEM
      \CurrentControlSet
          \Services
              \W3PCache
                 \Parameters

The following cache values are available:

Cache Path

The registry entries for cache path are located in:

HKEY_LOCAL_MACHINE
   SYSTEM
      \CurrentControlSet
          \Services
              \W3PCache
                 \Parameters
                    \Paths

Under that path are keys for each cache directory. The default keys are Path1 through Path5 (for a volume). Within each cache directory key are the following values:

CacheLimit
CachePath

Cache Filters

The Web Proxy Service cache filtering entries are located in:

HKEY_LOCAL_MACHINE
   SYSTEM
      \CurrentControlSet
          \Services
              \W3PCache
                 \UrlData

There can be zero, one, or more values in this key, depending on whether cache filters have been configured (by either creating a registry entry or by using the Web Proxy property sheets in Internet Service Manager). Registry values entered in the UrlData key take the form:

URL:REG_SZ:x,y

where

URL is the URL that is filtered.

x is either 0 or 1. An entry of 0 indicates that the URL will not be cached, and 1 indicates that the URL will be cached.

y is a number setting the TTL. This is an optional value that can only be set by editing the registry.

For details on cache filtering and URL cache filter syntax, see “Configuring the Web Proxy Service.”

WinSock Proxy Service Keys

The WinSock Proxy service registry values are located in:

HKEY_LOCAL_MACHINE
  SYSTEM
     \CurrentControlSet
        \Services
            \WSPSrv
               \Parameters
                 

The following values are available:

Other Keys Added for Microsoft Proxy Server

The following keys are added for use with Microsoft Proxy Server:

Current Version
SNMP

Current Version

This key indicates a path to where the Web Proxy Service Management Information Database (MIB) dynamic-link library (DLL) is installed. It is located in:

HKEY_LOCAL_MACHINE
  SOFTWARE
     \Microsoft
        \W3Proxy
           \CurrentVersion
              

The following value is available:

Pathname

SNMP

This key indicates a path to where the Winsock Proxy Service Management Information Database (MIB) DLL is installed. It is located in:

HKEY_LOCAL_MACHINE
  SYSTEM
     \CurrentControlSet
        \WSPSrv
           \SNMP
                  

The following value is available:

Pathname

© 1996 by Microsoft Corporation. All rights reserved.