[Handled] Section

[This is preliminary documentation and subject to change.]

You use this section to inform Windows NT Setup about files, directories, and registry entries in the active Windows 95 or Windows 98 installation you intend to migrate using your migration DLL.

Setup assumes that files, directories, and registry entries listed here are compatible with Windows NT 5.0. Therefore, it shall not warn users about incompatibilities associated with these components, nor will any processing be performed. For example, specifying a file path to a file in the system directory will cause it not to be moved to system32. Similarly, "handled" registry entries will not be copied to Windows NT.

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

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

The syntax for lines in this section is:

<Identifier Object> = <Identifier Type>

Identifier Object

Specifies the name or path to a Windows 95 or Windows 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 back slashes (\)

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 may contain square brackets ([ ]), tildes (~), or characters with values greater than 127. You must enclose hexadecimal value 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).