| Previous | Next |
| STATUS_CLOUD_FILE_UNSUCCESSFUL | STATUS_CLOUD_FILE_IN_USE |
STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT
The path is outside a registered cloud sync root
STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT means a Cloud Files operation was requested for a file or directory that is not under the sync root required by that operation. The useful question is therefore which path Windows resolved and which sync root owns it, not whether cloud storage in general is available.
What to capture
- Record the exact normalized path passed to the failing Cloud Filter API call and the operation being attempted.
- Identify the registered sync root and provider expected to own that path, including per-user or per-account root selection when several roots exist.
- Check whether a move, rename, junction, mount point, stale configuration, or path canonicalization caused the object to fall outside the registered root.
Recovery
Run the operation on an object inside the intended registered sync root, or correct the provider's sync-root registration and path selection before retrying. Resetting OneDrive, changing hydration policy, or restarting a provider is not a general remedy for this status: those actions address different failure modes unless evidence also shows a provider-state problem.
A useful regression test keeps the same provider and operation while varying only the target path across the sync-root boundary. The call should succeed or advance to a different result inside the root and reproduce this status outside it.
Official references
Looking for a different code? Search another status or error code.