[Incompatible Messages] Section

[This is preliminary documentation and subject to change.]

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.

The syntax for this section is:

<Message Object Section> = <Message>

Message Object Section

Specifies the name of a custom section (defined by your migration DLL) that contains a list of message objects such as files, directories, and registry entries. The name may be any combination of uppercase and lowercase letters, numbers, and spaces. It may not start or end with a space. By listing one or more message objects in a separate section, your DLL can associate several message objects with a single message. The value for Message Object Section is used as the component string in the compatibility report presented to the end user.

Message

Is a string describing the details of the incompatibility or message to be displayed to the user. The user will see the text in a multiline, scrollable, read-only edit control.

For example, this incompatibility section may contain the following line:

MyAppMsg = "The DOS and Real-mode portions of Myapp.exe are not supported on Windows NT"

Where MyAppMsg refers to another section containing the list of files, directories, and registry entries associated with the message string.

Notes When you write an entry to the [Incompatible Messages] section, a Message Object Section must provide one or more objects associated with the message.

Your migration DLL is responsible for managing the code page and language dependencies of the messages listed in this section. In particular, the text in the [Incompatible Messages] section must be in the same language as the active Windows 95 or Windows 98 system. Your DLL must not write messages to this section if it does not support the active operating system language.

The user has an option to view, print, or save the incompatibility report generated. This report will associate the ProductID with each Message.