B.2 Getting and Specifying a Decorated Name

Some uses of C++ function names require that you specify the name in its decorated form. Decorated names are required in the FUNCTIONS, EXPORTS, and IMPORTS statements in a .DEF file. This section describes how to get and use a decorated name.

For example, the FUNCTIONS statement in a .DEF file accepts one or more names of functions that are to be placed in a specified order or assigned to a segment or an overlay. To assign a C++ function using the FUNCTIONS statement, you must give the function's decorated name. However, the decorated name is not known until after compilation. Therefore, you must use the following procedure to get and use decorated names in a .DEF file:

1.Compile the object files for your program.

2.Create a .DEF file that does not yet specify the C++ functions.

3.Link your program using a form of the /MAP option.

4.Examine the map file to learn the decorated names of the functions.

5.Specify the decorated names in the places where you want to use the functions in the .DEF file.

6.Relink your program.

Warning:

If you change the function name, class, calling convention, any parameter, or the return type, the old decorated name is no longer valid. You must repeat this procedure and use the new version of the decorated name everywhere it is specified.