You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This error is reported when the linker fails to open a file, either for reading or for writing.
13
+
This error is reported when the linker fails to open a file, either for reading or for writing. The two most common causes of the issue are:
13
14
14
-
The most common cause of this problem is that your program is running, or is loaded in the debugger. Or, the file is locked by another process, such as an antivirus program. Perhaps the path to the file isn't correct, or there aren't double-quotes around a path that contains spaces. The file might not exist yet, if it's built by a different process. If the path isn't specified, perhaps the file can't be found in the default directories the linker searches. Or, you don't have sufficient permission to access the file. Less commonly, you may have run out of disk space. The file may be too large, or the path to the file is too long.
15
+
-your program is already running or is loaded in the debugger, and
15
16
16
-
To narrow down the possible causes, first check what kind of file *filename* is. Then, use the following sections to help identify and fix the specific issue.
17
+
- your library paths are incorrect, or aren't wrapped in double-quotes.
18
+
19
+
There are many other possible causes for this error. To narrow them down, first check what kind of file *filename* is. Then, use the following sections to help identify and fix the specific issue.
17
20
18
21
## Can't open your app or its .pdb file
19
22
20
-
If *filename* is your executable's name, or an associated .pdb file, see if your application is already running. Then check whether it's loaded in a debugger. To fix this issue, stop the program and unload it from the debugger before building it again. If the app is open in another program, such as a resource editor, close it. In extreme cases, you may need to use Task Manager to end the process. You might also need to stop and restart Visual Studio.
23
+
### Your app is running, or it's loaded in the debugger
24
+
25
+
When *filename* is your executable's name, or an associated .pdb file, see if your application is already running. Then check whether it's loaded in a debugger. To fix this issue, stop the program and unload it from the debugger before building it again. If the app is open in another program, such as a resource editor, close it. If your program is unresponsive, you may need to use Task Manager to end the process. You might also need to close and restart Visual Studio.
26
+
27
+
### Your app is locked by an antivirus scan
21
28
22
29
Antivirus programs often temporarily block access to newly created files, especially .exe and .dll executable files. To fix this issue, try excluding your project build directories from the antivirus scanner.
23
30
24
31
## Can't open a Microsoft library file
25
32
33
+
### Windows libraries, such as kernel32.lib
34
+
26
35
If the file that can't be opened is one of the standard library files provided by Microsoft, such as *kernel32.lib*, you may have a project configuration error or an installation error. Verify the Windows SDK has been installed. If your project requires other Microsoft libraries, such as MFC, make sure the MFC components were also installed by the Visual Studio installer. You can run the installer again to add optional components at any time. For more information, see [Modify Visual Studio](/visualstudio/install/modify-visual-studio). Use the **Individual components** tab in the installer to choose specific libraries and SDKs.
27
36
28
-
There are no Spectre-mitigated libraries for Universal Windows (UWP) apps or components. If the error message includes *vccorlib.lib*, you may have enabled [/Qspectre](../../build/reference/qspectre.md) in a UWP project. Disable the **/Qspectre** compiler option to fix this issue. In Visual Studio, change the **Spectre Mitigation** property. It's found in the **C/C++** > **Code Generation** page of the project **Property Pages** dialog.
37
+
### Versioned vcruntime libraries
29
38
30
39
If the error message has a versioned Microsoft library such as *msvcr120.lib*, the platform toolset for that compiler version may not be installed. To fix this issue, you have two options: Upgrade the project to use the current platform toolset, or install the older toolset and build the project unchanged. For more information, see [Upgrading Projects from Earlier Versions of Visual C++](../../porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md) and [Use native multi-targeting in Visual Studio to build old projects](../../porting/use-native-multi-targeting.md).
31
40
41
+
### Retail, Debug, or platform-specific libraries
42
+
32
43
The error may occur when you first build for a new target platform or configuration, such as Retail, or ARM64. In the IDE, verify the **Platform toolset** and **Windows SDK Version** specified in the [General property page](../../build/reference/general-property-page-project.md) are installed. Also verify the required libraries are available in the **Library Directories** specified in the [VC++ Directories Property Page](../../build/reference/vcpp-directories-property-page.md). Check the properties for each configuration, such as Debug, Retail, x86, or ARM64. If one build works but another doesn't, compare the settings for both. Install any missing required tools and libraries.
33
44
34
-
If you build a project copied from another computer, the library installation locations may be different. Check the **Library Directories** property on the [VC++ Directories Property Page](../../build/reference/vcpp-directories-property-page.md) for the project and update it if necessary. You can see and edit the current library paths set in the IDE. In the **VC++ Directories** page, choose the drop-down control for the **Library Directories** property, then choose **Edit**. The **Evaluated value** section of the **Library Directories** dialog lists the current paths searched for library files.
45
+
### The vccorlib.lib library
46
+
47
+
There are no Spectre-mitigated libraries for Universal Windows (UWP) apps or components. If the error message includes *vccorlib.lib*, you may have enabled [/Qspectre](../../build/reference/qspectre.md) in a UWP project. Disable the **/Qspectre** compiler option to fix this issue. In Visual Studio, change the **Spectre Mitigation** property. It's found in the **C/C++** > **Code Generation** page of the project **Property Pages** dialog.
48
+
49
+
### Libraries in projects from online or other sources
50
+
51
+
If you build a project copied from another computer, the library installation locations may be different. For command-line builds, verify the LIB environment variable and library paths are set correctly for the build. In Visual Studio, you can see and edit the current library paths set in the Property pages for your project. In the **VC++ Directories** page, choose the drop-down control for the **Library Directories** property, then choose **Edit**. The **Evaluated value** section of the **Library Directories** dialog lists the current paths searched for library files. Update these paths to point to your local libraries.
52
+
53
+
### Updated Windows SDK libraries
35
54
36
-
This error can also occur when the path to the Windows SDK is out of date. It may happen if you install a newer Windows SDK independently. To fix it, in Visual Studio, update the paths specified in the [VC++ Directories property page](../../build/reference/vcpp-directories-property-page.md)to match the new SDK. If you use the Developer Command Prompt, make sure the batch file that initializes the environment variables is updated for the new SDK paths. This problem can be avoided by using the Visual Studio installer to install updated SDKs.
55
+
This error can occur when the Visual Studio path to the Windows SDK is out of date. It may happen if you install a newer Windows SDK independently of the Visual Studio installer. To fix it in the IDE, update the paths specified in the [VC++ Directories property page](../../build/reference/vcpp-directories-property-page.md). Set the version in the path to match the new SDK. If you use the Developer Command Prompt, update the batch file that initializes the environment variables with the new SDK paths. This problem can be avoided by using the Visual Studio installer to install updated SDKs.
37
56
38
57
## Can't open a third-party library file
39
58
40
59
There are several common causes for this issue:
41
60
42
61
- The path to your library file may be incorrect, or not wrapped in double-quotes. Or, you may not have specified it to the linker.
43
62
44
-
- You may have installed a 32-bit version of the library, but you're building for 64 bits, or the other way around.
63
+
- You may have installed a 32-bit version of the library but you're building for 64 bits, or the other way around.
45
64
46
65
- The library may have dependencies on other libraries that aren't installed.
47
66
48
-
To fix a path issue, verify that the LIB environment variable is set. Make sure it contains all the directories for the libraries you use, for every configuration you build. In the IDE, the LIB variable is set by the **Library Directories**property on the [VC++ Directories Property Page](../../build/reference/vcpp-directories-property-page.md). Make sure all the directories that contain the libraries you need are listed here, for every configuration you build.
67
+
To fix a path issue for command-line builds, verify the LIB environment variable is set. Make sure it includes paths for all the libraries you use, and for every configuration you build. In the IDE, the library paths get set by the **VC++ Directories**> **Library Directories**property. Make sure all the directories that contain the libraries you need are listed here, for every configuration you build.
49
68
50
69
You might need to supply a library directory that overrides a standard library directory. On the command line, use the [/LIBPATH](../../build/reference/libpath-additional-libpath.md) option. In the IDE, use the **Additional Library Directories** property in the **Configuration Properties > Linker > General** property page for your project.
51
70
52
-
Make sure you install every version of the library you need for the configurations you build. Consider using the [vcpkg](../../vcpkg.md) package management utility to automate the installation and setup for many common libraries. When you can, it's best to build your own copies of third-party libraries. Then you're sure to have all the local dependencies that the libraries require, built for the same configurations as your project.
71
+
Make sure you install every version of the library you need for the configurations you build. Consider using the [vcpkg](../../vcpkg.md) package management utility to automate the installation and setup for many common libraries. When you can, it's best to build your own copies of third-party libraries. Then you're sure to have all the libraries' local dependencies, built for the same configurations as your project.
53
72
54
73
## Can't open a file built by your project
55
74
56
-
You may see this error if the file *filename* doesn't exist yet when the linker tries to access it. It can happen when one project depends on another project in a solution, but the projects don't build in the correct order. To fix this issue, make sure your project references are set in the project that uses the file. Then the missing file gets built before it's required. For more information, see [Adding references in Visual Studio C++ projects](../../build/adding-references-in-visual-cpp-projects.md) and [Managing references in a project](/visualstudio/ide/managing-references-in-a-project).
75
+
You may see this error if *filename* doesn't exist yet when the linker tries to access it. It can happen when one project depends on another in the solution, but the projects build in the wrong order. To fix this issue, make sure your project references are set in the project that uses the file. Then the missing file gets built before it's required. For more information, see [Adding references in Visual Studio C++ projects](../../build/adding-references-in-visual-cpp-projects.md) and [Managing references in a project](/visualstudio/ide/managing-references-in-a-project).
57
76
58
77
## Cannot open file 'C:\\Program.obj'
59
78
60
-
If you see the filename *C:\\Program.obj* in the error message, wrap your library paths in double quotes. This error happens when an unwrapped path that starts *C:\\Program Files* gets passed to the linker. Unwrapped paths can also cause similar errors that show an unexpected .obj file in the root of your drive.
79
+
If you see the filename *C:\\Program.obj* in the error message, wrap your library paths in double quotes. This error happens when an unwrapped path that begins with *C:\\Program Files* gets passed to the linker. Unwrapped paths may also cause similar errors. Typically, they show an unexpected .obj file in the root of your drive.
61
80
62
81
To fix this issue for command-line builds, check the [/LIBPATH](../../build/reference/libpath-additional-libpath.md) option parameters. Also check the paths specified in the LIB environment variable, and the paths specified on the command line. Make sure to use double-quotes around any paths that include spaces.
63
82
64
-
To fix this issue in the IDE, add quotes as necessary to the following properties for your project:
83
+
To fix this issue in the IDE, add double-quotes as necessary to the following properties for your project:
65
84
66
85
- The **Library Directories** property on the [Configuration Properties > VC++ Directories](../../build/reference/vcpp-directories-property-page.md) property page,
67
86
68
87
- The **Additional Library Directories** property in the **Configuration Properties > Linker > General** property page,
69
88
70
89
- The **Additional Dependencies** property in the **Configuration Properties > Linker > Input** property page.
71
90
72
-
### Other common issues
91
+
## Other common issues
92
+
93
+
### Path or filename issues
73
94
74
95
This error can occur when the library filename or path specified to the linker is incorrect. Or, when the path has an invalid drive specification. Look on the command line or in any [#pragma comment( lib, "library_name" )](../../preprocessor/comment-c-cpp.md) directive for issues. Check your spelling and the file extension, and verify the file exists at the specified location.
75
96
76
-
An antivirus program may have the file open for scanning. Antivirus programs often temporarily block access to newly created files. To fix this issue, try excluding your project build directories from the antivirus scanner.
97
+
### Parallel build synchronization
98
+
99
+
If you're using a parallel build option, Visual Studio may have locked the file on another thread. To fix this issue, verify the same code object or library isn't built in multiple projects. Use build dependencies or project references to pick up built binaries in your project.
77
100
78
-
If you're using a parallel build option, it's possible that Visual Studio has locked the file on another thread. To fix this issue, verify the same code object or library isn't built in multiple projects. Use build dependencies or project references to pick up built binaries in your project.
101
+
### Additional dependencies specified in the IDE
79
102
80
103
When you specify individual libraries in the **Additional Dependencies** property directly, use spaces to separate the library names. Don't use commas or semicolons. If you use the **Edit** menu item to open the **Additional Dependencies** dialog box, use newlines to separate the names, not commas, semicolons, or spaces. Also use newlines when you specify library paths in the **Library Directories** and **Additional Library Directories** dialog boxes.
81
104
82
-
You may see this error when the path for *filename* expands to more than 260 characters. Change the names or rearrange your directory structure if needed to shorten the paths to the required files.
105
+
### Paths that are too long
106
+
107
+
You may see this error when the path for *filename* expands to more than 260 characters. If needed, rearrange your directory structure or shorten your folder and file names to shorten the paths.
108
+
109
+
### Files that are too large
83
110
84
111
This error can occur because the file is too large. Libraries or object files more than a gigabyte in size may cause problems for the 32-bit linker. A possible fix for this issue is to use the 64-bit toolset. For more information on how to use the 64-bit toolset at the command line, see [How to: Enable a 64-Bit Visual C++ Toolset on the Command Line](../../build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md). For information on how to use the 64-bit toolset in the IDE, see [Using MSBuild with the 64-bit Compiler and Tools](../../build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md#using-msbuild-to-build-your-project). Also see this Stack Overflow post: [How to make Visual Studio use the native amd64 toolchain](https://stackoverflow.com/questions/19820718/how-to-make-visual-studio-use-the-native-amd64-toolchain/23793055).
85
112
86
-
This error can occur if you have insufficient file permissions to access *filename*. It may happen if you use an ordinary user account to access library files in protected system directories. Or, if you use files copied from other users that have their original permissions set. To fix this issue, move the file to a writeable project directory. If the moved file has inaccessible permissions, run the takeown.exe command in an Administrator command window to take ownership of the file.
113
+
### Incorrect file permissions
114
+
115
+
This error can occur if you have insufficient file permissions to access *filename*. It may happen if you use an ordinary user account to access library files in protected system directories. Or, if you use files copied from other users that still have their original permissions set. To fix this issue, move the file to a writeable project directory. If the moved file has inaccessible permissions, run the takeown.exe command in an Administrator command window to take ownership of the file.
116
+
117
+
### Insufficient disk space
87
118
88
119
The error can occur when you don't have enough disk space. The linker uses temporary files in several cases. Even if you have sufficient disk space, a large link can deplete or fragment the available disk space. Consider using the [/OPT (Optimizations)](../../build/reference/opt-optimizations.md) option; doing transitive COMDAT elimination reads all the object files multiple times.
89
120
121
+
### Problems in the TMP environment variable
122
+
90
123
If the *filename* is named LNK*nnn*, it's a filename generated by the linker for a temporary file. The directory specified in the TMP environment variable may not exist. Or, more than one directory may be specified for the TMP environment variable. Only one directory path should be specified for the TMP environment variable.
124
+
125
+
## Help, my issue isn't listed here!
126
+
127
+
When none of the issues listed here apply, you can use the feedback tools in Visual Studio for help. In the IDE, go to the menu bar and choose **Help > Send Feedback > Report a Problem**. Or, submit a suggestion by using **Help > Send Feedback > Send a Suggestion**. You can also use the Visual Studio C++ [Developer Community](https://developercommunity.visualstudio.com/spaces/62/index.html)) website. Use it to search for answers to questions and ask for help. For more information, see [How to report a problem with the Visual C++ toolset or documentation](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md).
128
+
129
+
If you've discovered a new way to fix this issue that we should add to this article, let us know. You can send us feedback by using the button below for **this page**. Use it to create a new issue in our [C++ documentation GitHub repo](https://github.com/MicrosoftDocs/cpp-docs/issues). Thanks!
0 commit comments