[Handled] Section

Use this section to inform Windows 2000 Setup about files, directories, and registry entries in the active Windows 95/98 installation you intend to handle using your migration DLL.

Setup assumes that files, directories, and registry entries listed here are compatible with Windows 2000. Therefore, Setup does not warn users about incompatibilities associated with these components and does not perform any processing. For example, specifying a path to a file in the System folder ensures that the file will not be moved to the System32 folder. Similarly, handled registry entries are not copied to Windows 2000.

All file names, directories, and registry entries listed in this section must be valid on the active Windows 95/98 system.

You can use the WritePrivateProfileString function to add lines to this section.

The syntax for this section is:

<Identifier Object> = <Identifier Type>

Identifier Object

Specifies the name or path to a Windows 95/98 file, directory, or registry location. Files and directories are in long file name format. Registry paths are of the form:

<Root>\<SubKey>\<SubKey>\<…> [<Value Name>]

where:

Root

Specifies the registry root. It can be any one of HKEY_LOCAL_MACHINE, HKLM, HKEY_ROOT, or HKR. Migration DLLs can only handle a registry key for all users, not for individual users.

SubKey

Specifies one or more registry keys separated by backslashes (\).

Value Name

Optional. Specifies a registry value name enclosed in square brackets. An empty square bracket ([ ]) specifies the default value for the specified key name.

Registry keys or value names themselves can contain square brackets ([ ]), tildes (~), or characters with values greater than 127. You must enclose hexadecimal values for these characters in tildes (~) when writing them as registry values to the [Handled] section. For more information, see Handling Special String Characters.

Identifier Type

Identifies the type of <Identifier Object> to be handled. It must be one of the following three values:

File

The object specified refers to a long file name (including the full path to the file). This must be a full path, without environment variables and without short versions of long file names.

Directory

The object specified refers to a directory (including the full path to the directory).

Registry

The object specified refers to a registry key (including the full path to that key).

Report

Indicates Object is a registry location. This type causes Setup to continue to process Object, but not display messages associated with Object in the incompatibility report.