| Previous | Next |
| ERROR_PWD_TOO_LONG | ERROR_ASSERTION_FAILURE |
ERROR_FILE_SYSTEM_LIMITATION
What ERROR_FILE_SYSTEM_LIMITATION means
The API and path can be valid while the target volume cannot represent the requested file size, allocation pattern, metadata, link count, stream, sparse range, or another feature. The precise limit depends on the file system, format version, and volume configuration.
Where it commonly appears
- Very large files or highly fragmented sparse files
- Applications using alternate data streams, links, or advanced metadata
- Copies between different file-system types
- Backup, archive, and virtualization workloads
Likely causes
- The file or allocation reaches a file-system structural limit
- The destination lacks a feature supported by the source
- Metadata or extent counts are exhausted
- A legacy or removable-media format has smaller limits
- The operation requests an unsupported combination of flags
Troubleshooting checklist
- Identify the exact source and destination file systems and volume parameters
- Record file size, allocation size, stream count, link count, and operation flags
- Test a smaller or simpler file on the same volume
- Check file-system and storage event logs
- Avoid assuming free space is the only relevant capacity
Guidance for developers
Detect destination capabilities before large transfers when possible. Break data into supported units, choose a compatible volume, or use a container format that does not require unsupported metadata. Preserve the partial-output state for safe cleanup.
Guidance for administrators
Move the workload to a suitable file system, reformat only with proper backup, or reduce the object’s structural complexity. Running cleanup tools will not remove an inherent format limit.
Example
A virtual disk grows into a pattern with too many extents for the target volume. Plenty of bytes remain free, but the file system cannot represent another allocation and returns this code. Moving the file to a more suitable volume resolves it.
Related conditions
ERROR_DISK_FULL means capacity is exhausted; this code can occur with substantial free space. ERROR_FILE_TOO_LARGE is a more specific size-related condition.
References
Looking for a different code? Search another status or error code.