| Previous | Next |
| ERROR_CLOUD_FILE_ACCESS_DENIED | ERROR_CLOUD_FILE_PROPERTY_LOCK_CONFLICT |
ERROR_CLOUD_FILE_INCOMPATIBLE_HARDLINKS
The file's hard links cannot be represented by the configured cloud policy
ERROR_CLOUD_FILE_INCOMPATIBLE_HARDLINKS is tied to the sync root's hard-link policy. Hard links are disabled for placeholders by default. When enabled, links are supported only within policy-defined boundaries; the platform can hydrate a placeholder when the first link outside the root appears and revert it to a normal file when the last in-root link is removed.
Enumerate all hard-link names and identify which are inside the same sync root, outside any root, or under a different root. Compare that topology with CF_HARDLINK_POLICY registered for the provider. Do not delete an arbitrary link before checking whether applications depend on it and whether unsynchronized changes exist. The provider must either support the topology explicitly or reject operations that would make cloud identity ambiguous.
What to inspect
- Enumerate every hard-link path for the file and classify it by sync root.
- Verify that hard-link support was enabled in CF_SYNC_POLICIES.
- Preserve local modifications before reverting or restructuring links.
References
- Microsoft: CFAPI hard-link policy
- Microsoft: hard-link behavior in CF_SYNC_POLICIES
- Microsoft: reverting placeholder characteristics
Looking for a different code? Search another status or error code.