Skip to content

Commit 49eea6e

Browse files
Deland-HanDeland-Han
authored
Merge pull request #8673 from Deland-Han/cmpy-branch-ci4643
AB#4643: Troubleshoot Windows Update Error 0x80070490
2 parents 0e72413 + 5cc170b commit 49eea6e

File tree

4 files changed

+170
-0
lines changed

4 files changed

+170
-0
lines changed

‎support/azure/virtual-machines/windows/toc.yml‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -224,6 +224,10 @@
224224
href: in-place-system-upgrade.md
225225
- name: Upgrade VM to contain more than 64 vCPUs
226226
href: vm-cannot-upgrade-64-vcpu.md
227+
- name: Known errors and issues
228+
items:
229+
- name: Troubleshoot Windows Update Error 0x80070490
230+
href: ../../../windows-server/installing-updates-features-roles/troubleshoot-windows-update-error-0x80070490.md?context=/troubleshoot/azure/virtual-machines/windows/context/context
227231

228232
- name: My VM is not booting
229233
items:

‎support/windows-server/installing-updates-features-roles/media/troubleshoot-windows-update-error-0x80070490/wusa-error-0x80070490.png‎

89.5 KB
Loading

‎support/windows-server/installing-updates-features-roles/troubleshoot-windows-update-error-0x80070490.md‎

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
---
2+
title: Troubleshoot Windows Update Error 0x80070490
3+
description: Learn how to resolve Windows Update error 0x80070490, which occurs due to driver failures during update installations.
4+
ms.date: 04/15/2025
5+
manager: dcscontentpm
6+
audience: itpro
7+
ms.topic: troubleshooting
8+
ms.reviewer: scotro,mwesley
9+
ms.custom:
10+
- sap:windows servicing,updates and features on demand\windows update fails - installation stops with error
11+
- pcy:WinComm Devices Deploy
12+
---
13+
# Troubleshoot Windows Update error 0x80070490
14+
15+
Windows Update error 0x80070490 typically occurs due to driver failures when users or administrators try to install updates. This document provides a comprehensive guide to identifying and resolving this error, which can manifest in various symptoms such as pending updates, failed servicing stack updates, and feature update installation failures.
16+
17+
:::image type="content" source="./media/troubleshoot-windows-update-error-0x80070490/wusa-error-0x80070490.png" alt-text="Screenshot showing the Windows Update error 0x80070490." lightbox="./media/troubleshoot-windows-update-error-0x80070490/wusa-error-0x80070490.png":::
18+
19+
## Prerequisites
20+
21+
Before proceeding with the mitigations, ensure you have backed up the OS disk. If you're using Windows in an Azure virtual machine (VM), refer to [Back up an Azure VM from the VM settings ](/azure/backup/backup-azure-vms) for detailed instructions.
22+
23+
## Root cause
24+
25+
The primary cause of error 0x80070490 is driver failures during Windows Update installations. This failure can occur due to:
26+
27+
- Pending updates that block new installations.
28+
- Stale or incorrect registry entries related to driver operations.
29+
- Corrupted or malformed **SetupConfig.ini** files.
30+
- Missing driver files or hard links in the system directories.
31+
32+
## CBS logs
33+
34+
When troubleshooting Windows Update issues, CBS logs are helpful for identifying the root cause.
35+
36+
The CBS log is located at `C:\Windows\Logs\CBS\CBS.log`. The log can roll over from CBS.log to CBSpersisttXXXXXXXXXXXXX.log or CBSpersisttXXXXXXXXXXXXX.cab within the same folder.
37+
38+
## Symptom 1: Pending update state
39+
40+
When an update is in an "Install Pending" state, the driver operation might fail due to an inability to read the identity of the driver operation sequence ID 1. Check the CBS logs at `C:\Windows\Logs\CBS\CBS.log` for entries like:
41+
42+
```output
43+
Info CBS Failed reading Identity for driver operation sequenceID 1 [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
44+
Info CBS Failed loading a driver operation [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
45+
Error CBS Doqi: Failed loading driver operations queue. [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
46+
Info CBS Failed loading driver operation queue [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
47+
Info CBS Failed initializing driver operation queue [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
48+
Info CBS Perf: InstallUninstallChain complete.
49+
```
50+
51+
### Resolution: Resolve pending updates
52+
53+
1. Remove the `1` folder from the registry path: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\DriverOperations\1`.
54+
2. Set the trusted installer to the automatic state using the command:
55+
56+
```console
57+
sc config trustedinstaller start=demand
58+
```
59+
60+
3. Try to install the updates again.
61+
62+
## Symptom 2: Servicing stack update failure
63+
64+
Servicing stack updates (SSUs) might fail with error 0x80070490. Check the **CBS.log** file for entries like:
65+
66+
```output
67+
Error CBS Doqi: Failed loading driver operations queue. [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
68+
Info CBS Failed initializing driver operation queue [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
69+
Info CBS Perf: InstallUninstallChain complete.
70+
Info CSI 000013c6@2020/2/6:18:53:04.849 CSI Transaction @0x1d2174564c0 destroyed
71+
Info CBS Failed to execute execution chain. [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
72+
Error CBS Failed to process single phase execution. [HRESULT = 0x80070490 - ERROR_NOT_FOUND]
73+
```
74+
75+
### Resolution: Reinstall the SSU
76+
77+
1. Export and delete the key at `HKLM\SOFTWARE\Microsoft\Windows\Currentversion\Component Based Servcing\Driver Operations\0`.
78+
2. Reinstall the SSU.
79+
80+
## Symptom 3: Feature update installation failure
81+
82+
Feature updates might fail with error code 0x80070490. This behavior can be observed through **Check for updates** and in the Software Center (WSUS). Review the **WindowsUpdate.log** file for entries like:
83+
84+
```output
85+
hh:mm:ss.fffff tt 1092 10968 downloadmanager_cpp16907 [DownloadManager] Preparing update for install, updateId = {UpdateID}.202.
86+
hh:mm:ss.fffff tt 11736 12104 uhwinsetup_cpp739 [Handler] * START * Windows Setup Install
87+
hh:mm:ss.fffff tt 11736 12104 uhwinsetup_cpp741 [Handler] Updates to install = 1
88+
hh:mm:ss.fffff tt 11736 12104 uhwinsetuppersisteddata_cpp233 [Handler] Loaded state. m_dwState now: Setup360_CompatToolPhase1(5)
89+
hh:mm:ss.fffff tt 11736 12104 uhwinsetupsession_cpp322 [Handler] Starting Windows Setup with command line = "C:\Windows\SoftwareDistribution\Download\4222e87ece5856088671b07affd003c5\WindowsUpdateBox.exe" /ClassId <ClassID> /ReportId {ReportID}.202 /PreDownload /Update /ClientId <ClientID> /CorrelationVector cFZ4O8G6gEWSekro.2.1.2
90+
hh:mm:ss.fffff tt 11736 12104 uhwinsetupsession_cpp1655 [Handler] Registering WinSetup COM server as CLSID {CLSID} and APPID {APPID}
91+
hh:mm:ss.fffff tt 11736 12104 uhwinsetupsession_cpp1673 [Handler] Successfully registered WinSetup COM server as CLSID {CLSID}
92+
hh:mm:ss.fffff tt 11736 12104 uhwinsetupsession_cpp458 [Handler] Installer completed. Process return code = 0x80070490, result = 0x80070490, callback pending = False
93+
hh:mm:ss.fffff tt 11736 12104 setup360installer_cpp490 [Handler] Handler: Setup360 returned unknown error 80070490 for state 5, resetting state to Unknown
94+
hh:mm:ss.fffff tt 11736 12104 uhwinsetuppersisteddata_cpp155 [Handler] State changed. was: Setup360_CompatToolPhase1(5), now: <invalid>(0)
95+
hh:mm:ss.fffff tt 11736 12104 uhwinsetuppersisteddata_cpp296 [Handler] Saved state. m_dwState: <invalid>(0)
96+
hh:mm:ss.fffff tt 11736 12104 uhwinsetup_cpp776 [Handler] Exit code = 0x80070490
97+
```
98+
99+
### Resolution: Fix SetupConfig.ini
100+
101+
1. Remove or fix the **SetupConfig.ini** file located at `C:\Users\Default\AppData\Local\Microsoft\Windows\WSUS\SetupConfig.ini`.
102+
2. If the file is empty, add an entry such as `Show OOBE =None`.
103+
104+
## Symptom 4: Cumulative update failure
105+
106+
Cumulative updates might fail with error code 0x80070490 along with 0x8e5e03fa. Check the Setup Events logs for errors like:
107+
108+
```output
109+
Information XXXXXXX.corp. 1 Microsoft-Windows-Servicing N/A NT AUTHORITY\SYSTEM Initiating changes for package KB5004122. Current state is Resolved. Target state is Installed. Client id: WindowsUpdateAgent.
110+
Information XXXXX.corp. 3 Microsoft-Windows-Servicing N/A NT AUTHORITY\SYSTEM Package KB5004122 failed to be changed to the Installed state. Status: 0x8e5e03fa.
111+
Information XXXXX.corp. 1 Microsoft-Windows-Servicing N/A NT AUTHORITY\SYSTEM Initiating changes for package KB5004298. Current state is Resolved. Target state is Installed. Client id: WindowsUpdateAgent.
112+
Information XXXXX.corp. 3 Microsoft-Windows-Servicing N/A NT AUTHORITY\SYSTEM Package KB5004298 failed to be changed to the Installed state. Status: 0x8e5e03fa.
113+
Error XXXX.corp. 3 Microsoft-Windows-WUSA N/A CORP\xxa790741it5 Windows update "Security Update for Windows (KB5004298)" could not be installed because of error 2388526074 "" (Command line: ""C:\Windows\system32\wusa.exe" "C:\Users\XXXXX\Desktop\WS2012R2-072021\windows8.1-kb5004298-x64_e98bbac284034aac90559c0d311967d97ebfc0e5.msu" ")
114+
```
115+
116+
### Resolution: Repair system corruption
117+
118+
1. Start the corruption repair process:
119+
120+
```console
121+
DISM /Online /Cleanup-Image /RestoreHealth
122+
SFC /Scannow
123+
```
124+
125+
2. Reset the contents of the **Catroot2** folder:
126+
127+
```console
128+
net stop cryptsvc
129+
md %systemroot%\system32\catroot2.old
130+
xcopy %systemroot%\system32\catroot2 %systemroot%\system32\catroot2.old /s
131+
del %systemroot%\system32\catroot2\* /q
132+
net start cryptsvc
133+
```
134+
135+
3. Rename the **Software Distribution** folder:
136+
137+
```console
138+
net stop wuauserv
139+
cd %systemroot%
140+
ren SoftwareDistribution SoftwareDistribution.old
141+
net start wuauserv
142+
```
143+
144+
4. Install the patch.
145+
146+
## Symptom 5: Monthly rollup update failure
147+
148+
Monthly rollup updates might fail with error code 0x80070490. Check the CBS logs for entries like:
149+
150+
```output
151+
Error CBS Shtd: Failed while processing non-critical driver operationsqueue. [HRESULT = 0x80070490 – ERROR_NOT_FOUND]
152+
Info CBS Shtd: Rolling back KTM, because drivers failed.
153+
Info CBS Progress: UI message updated. Operation type: Update. Stage: 1 out of 1. Temporary Rollback.
154+
```
155+
156+
### Resolution: Address missing driver files
157+
158+
1. Create the **wvms_pp.inf_amd64_81d18de8dedd4cc4** folder inside `C:\Windows\System32\DriverStore\FileRepository`.
159+
2. Copy all `.inf` files from `C:\Windows\WinSxS\amd64_wvms_pp.inf_31bf3856ad364e35_6.2.9200.22376_none_bc457897943a83fe`.
160+
3. Load the driver hive and check for the `wvms_pp.inf` driver in the registry path: `HKEY_LOCAL_MACHINE\<Driver Hive>\DriverDatabase\DriverInfFiles\wvms_pp.inf`.
161+
162+
## Next steps
163+
164+
If the issue persists, consider engaging with the WSUS team for further assistance. You can also explore additional resources on Windows Update troubleshooting in the [Windows Server update troubleshooting guidance](troubleshoot-windows-server-update-guidance.md).

‎support/windows-server/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3055,6 +3055,8 @@ items:
30553055
href: ./installing-updates-features-roles/wsus-clients-cant-install-updates.md
30563056
- name: Windows Update fails - installation stops with error
30573057
items:
3058+
- name: Troubleshoot Windows Update error 0x80070490
3059+
href: installing-updates-features-roles/troubleshoot-windows-update-error-0x80070490.md
30583060
- name: 'Troubleshooting guidance: Windows Server update'
30593061
href: ./installing-updates-features-roles/troubleshoot-windows-server-update-guidance.md
30603062
- name: CBS.log file contains entries that some files aren't repaired

0 commit comments

Comments
 (0)