| Previous | Next |
| ERROR_FAIL_SHUTDOWN | ERROR_MAX_SESSIONS_REACHED |
ERROR_FAIL_RESTART
The system restart request failed
ERROR_FAIL_RESTART is a Win32 system result. A restart request can be rejected or fail before the machine enters shutdown. Common contexts include installers, remote administration, servicing, and recovery workflows.
What the result means
Windows could not complete the requested restart operation. For ERROR_FAIL_RESTART, keep the symbolic name, numeric value, and failing operation together in diagnostics; that combination distinguishes the exact failure path from nearby system results.
What to check
- Record the restart API, flags, reason, caller privileges, and whether the request was local or remote.
- Review shutdown, service-control, and system event logs.
- Check for policy restrictions, pending user interaction, or components refusing transition.
- Verify that the machine did not restart under a different management channel.
Recommended handling
Keep the operation in a reboot-pending state and notify the operator. Retry only after the blocking condition is understood, preferably through the system’s supported restart mechanism.
Developer notes
Automation should distinguish “restart requested” from “restart observed.” Use an external health or boot identifier to confirm completion after connectivity returns. When a Win32 API reports ERROR_FAIL_RESTART, capture GetLastError() immediately; subsequent cleanup, formatting, or logging calls can replace the thread-local value.
References
Looking for a different code? Search another status or error code.
