Diagnose Web Content Download Issues
- Last UpdatedMay 04, 2026
- 2 minute read
If a download from a Web Content control is not successful, an error message will be added to the syslog.dat file. For example:
Web Content download of 'https://example.com/test.pdf' to 'C:\download' failed with error 2
You can use the error code provided at the end of this message to determine why a download did not succeed (see the table below).
Note:
• The parameter [Client]DisableWebContentDownloads can be used to disable download links displayed in a Web Content control.
• The parameter [Client]WebContentDownloadPath can be used to specify a non-default download path.
When diagnosing download issues, you should check the configuration of these parameters.
|
Error code |
Description |
|
1 |
Generic file error. |
|
2 |
Access denied due to security restrictions. |
|
3 |
Disk full. User should free some space or choose a different location to store the file. |
|
4 |
The resulting file path with file name is too long. |
|
5 |
File is too large for file system. |
|
6 |
Microsoft Defender SmartScreen detected a virus in the file. |
|
7 |
File was in use, too many files opened, or out of memory. |
|
8 |
File blocked by local policy. |
|
9 |
Security check failed unexpectedly. Microsoft Defender SmartScreen could not scan this file. |
|
10 |
Seeking past the end of a file in opening a file, as part of resuming an interrupted download. The file did not exist or was not as large as expected. Partially downloaded file was truncated or deleted, and download will be restarted automatically. |
|
11 |
Partial file did not match the expected hash and was deleted. Download will be restarted automatically. |
|
12 |
Generic network error. User can retry the download manually. |
|
13 |
Network operation timed out. |
|
14 |
Network connection lost. User can retry the download manually. |
|
15 |
Server has gone down. User can retry the download manually. |
|
16 |
Network request invalid because original or redirected URI is invalid, has an unsupported scheme, or is disallowed by network policy. |
|
17 |
Generic server error. User can retry the download manually. |
|
18 |
Server does not support range requests. |
|
19 |
Server does not have the requested data. |
|
20 |
Server did not authorize access to resource. |
|
21 |
Server certificate problem. |
|
22 |
Server access forbidden. |
|
23 |
Unexpected server response. Responding server may not be intended server. User can retry the download manually. |
|
24 |
Server sent fewer bytes than the content-length header. Content-length header may be invalid or connection may have closed. Download is treated as complete unless there are strong validator present to interrupt the download. |
|
25 |
Unexpected cross-origin redirect. |
|
26 |
User canceled the download. |
|
27 |
User shut down the WebView. Resuming downloads that were interrupted during shutdown is not yet supported. |
|
28 |
User paused the download. |
|
29 |
WebView stopped working. |