| Previous | Next |
| ERROR_CLOUD_FILE_INSUFFICIENT_RESOURCES | ERROR_CLOUD_FILE_UNSUCCESSFUL |
ERROR_CLOUD_FILE_NETWORK_UNAVAILABLE
The placeholder operation requires remote data while connectivity is unavailable
ERROR_CLOUD_FILE_NETWORK_UNAVAILABLE is normally returned by the provider when a fetch, validation, enumeration, or upload cannot reach its backing service. It is distinct from provider-not-running: the callback channel can be healthy while the provider has no usable route, name resolution, proxy path, or remote session.
Correlate the CFAPI request with the provider's remote endpoint, DNS and proxy results, offline detection, and retry policy. A hydrated range may remain readable locally even when another range needs the network. Do not mark a placeholder in sync merely because the failure is temporary. Preserve cancellation and request identity so a later retry does not deliver bytes to an obsolete transfer key or remote version.
What to inspect
- Test the exact provider endpoint and proxy context used by the running process.
- Record whether the requested range is already present locally.
- Retry with backoff while preserving remote-version and transfer-key correctness.
References
- Microsoft: missing ranges trigger provider fetches
- Microsoft: transfer keys and data completion
- Microsoft: on-disk and validated data sizes
Looking for a different code? Search another status or error code.