[This is preliminary documentation and subject to change.]
During the Windows 95 or Windows 98 phase of the upgrade, Windows NT Setup creates and uses MIGRATE.INF files to collect file information from all migration DLLs. During the Windows NT portion of the upgrade, Setup uses this same file to provide that information back to the submitting migration DLL.
Each working directory passed to a migration DLL has a MIGRATE.INF file in it. The sections are:
| Section | Description |
|---|---|
| [Version] | This is a generic section required for every Windows 95- and Windows 98-style INF. It contains information about the version of Windows NT being used for the upgrade. Setup writes to this section. |
| [Migration Paths] | This section contains a list of Win32 paths to files requested by your migration DLL through the QueryVersion function ExeNamesBuf parameter. Each line represents the full path to a file. Setup writes to this section. |
| [Excluded Paths] | This section contains a list of paths not part of the active Windows 95 or Windows 98 system configuration. Setup does not search through any of these paths or their subdirectories. Excluded paths include directories on the system drive used by other operating systems, network drives, and substituted or compressed drives. Setup writes to this section. |
| [Handled] | 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, users will not be warned about incompatibilities associated with these components. 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 for adding lines to this section. |
| [Moved] | You use this section to inform Windows NT Setup about files and directories you plan to move, rename, or delete during the migration. This enables Setup to adjust the relevant Windows NT Explorer shell links. You can use the WritePrivateProfileString function for adding lines to this section. |
| [Incompatible Messages] | You use this section to present messages to a user through the Setup incompatibility report (displayed during the Windows 95 or Windows 98 phase of the upgrade process). The report is presented to the user before any changes are made to the computer and is useful when you intend to change the behavior of an application or when you plan to remove application components. |
| [<Message Object Section>] | A message object section provides a mechanism for you to associate one or more message objects (file, directory, and registry location) with a message specified in the [Incompatible Messages] section. |
| [Windows NT Disk Space Requirements] | You use this section to specify the amount of disk space (on a per drive basis) your migration DLL requires during the Windows NT phase of the upgrade. Setup uses this information to calculate the total amount of space required for the upgrade. If sufficient space is unavailable, Setup informs the user accordingly during the Windows 95 or Windows 98 phase of the upgrade. |