|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
/Gy (Enable Function-Level Linking)
Updated: July 2008
Allows the compiler to package individual functions in the form of packaged functions (COMDATs).
The linker requires that functions be packaged separately as COMDATs to exclude or order individual functions in a DLL or .exe file.
You can use the linker option /OPT (Optimizations) to exclude unreferenced packaged functions from the .exe file.
You can use the linker option /ORDER (Put Functions in Order) to include packaged functions in a specified order in the .exe file.
Inline functions are always packaged if they are instantiated as calls (which occurs, for example, if inlining is off or you take a function address). In addition, C++ member functions defined in the class declaration are automatically packaged; other functions are not, and selecting this option is required to compile them as packaged functions.
The /ZI option, used for Edit and Continue, automatically sets the /Gy option.
To set this compiler option in the Visual Studio development environment
Open the project's Property Pages dialog box. For details, see How to: Open Project Property Pages.
Click the C/C++ folder.
Click the Code Generation property page.
Modify the Enable Function-Level Linking property.