KB126646 - You receive error messages when you try to compile an MFC application by using the single-threaded run-time library in Visual C++: "Error LNK2001: unresolved external symbol"

RESOLUTION

On Microsoft Visual C++ 2005 or on Microsoft Visual C++ .NET

To set the option, read the online help topic under Setting Visual C++ Project Properties.

On Microsoft Visual C ++ 2.x, 5.0, and 6.0

Select the Project menu.
Select the Settings... option.
Select the C/C++ tab.
Select Code Generation on the Category list box.
Finally, make a selection other than Single-Threaded on the Use Run Time Library list box.

On Microsoft Visual C++ 4.x

Select the Build menu.
Select the Settings... option.
Select the C/C++ tab.
Select Code Generation on the Category list box.
Finally, make a selection other than Single-Threaded on the Use Run Time Library list box.

MORE INFORMATION

For Win32s, MFC version 3.0 and later versions do not create additional threads. However, the MFC does use Thread Local Storage (TLS) in the multithreaded libraries to provide per-process data in DLLs that are used by multiple applications under Win32s.

In the Project Settings dialog box, if you select the run-time library option to link "Multithreaded using DLL," you can take advantage of using the shared DLL, MSVCRTx0.DLL (where x represents the major version of Visual C++). There are separate versions of MSVCRTx0.DLL for Windows NT and Win32s that cannot be interchanged. "Multithreaded using DLL" is required when building an AFXDLL.

Linking to the multithreaded libraries may cause multiple defined symbol errors. This usually occurs when the application uses user-created or third-party static libraries that were created as single-threaded.

The best solution in this case is to rebuild the static libraries to use the same library options as MFC (either /MT or /MD, depending on which MFC lib is used).

In this case, you may be able to use /NOD:LIBC.LIB. However, if the static library accesses any static global C Run-Time data such as _errno or stdin, you will get unresolved externals on these symbols.

One solution which will always work is to isolate the single-threaded code into a DLL, and call it, protected by semaphores, from the multithreaded MFC code.

You receive error messages when you try to compile an MFC application by using the single-threaded run-time library in Visual C++: "Error LNK2001: unresolved external symbol"

SYMPTOMS

CAUSE

RESOLUTION

STATUS

MORE INFORMATION

REFERENCES