| Previous | Next |
| ERROR_NOT_A_TIERED_VOLUME | ONL_E_INVALID_AUTHENTICATION_TARGET |
ERROR_ATTRIBUTE_NOT_PRESENT
The actionable meaning of missing storage-tiering file attribute comes from the component that returned it. The HRESULT belongs to the storage-tiering facility and records that the requested tiering-related attribute is absent on the selected file or directory. Absence is a capability/state result, not proof that the path itself is missing.
The relevant contract
Missing attribute is distinct from unsupported information class, access denied, or a stale path. The object can exist and be readable while the optional metadata is not present. Keep ERROR_ATTRIBUTE_NOT_PRESENT, its numeric value, and the first returning operation together.
Capture before changing state
| Capture | Diagnostic value |
|---|---|
| Exact attribute class or information request, file ID/path, volume, filesystem, and handle access flags. | Identifies the concrete object and operation associated with missing storage-tiering file attribute. |
| Storage-tier inventory and whether the object is a placeholder, pinned file, reparse point, or ordinary resident file. | Separates argument or lifecycle state from a lower-layer provider failure. |
| The API that queried the attribute and the returned buffer/version before interpretation. | Creates a stable before-and-after comparison. |
| A sibling object created by the same policy that does expose the requested attribute. | Shows whether this condition is the first result or a translated summary. |
Preserve the API that queried the attribute and the returned buffer/version before interpretation before reinstalling, rebooting, clearing state, or substituting another device or provider.
Focused experiments
- Query the same attribute on a known tiered object and on a normal file on the same volume. Treat a changed result as a separate failure rather than automatic resolution.
- Open by file ID or stable handle to exclude path replacement between enumeration and query. Repeat the original supported operation so the check remains tied to the same API boundary.
- Change only the placement/tiering policy in a test volume and observe when the attribute appears. Keep unrelated inputs fixed so the changed result remains attributable to the tested variable.
A defensible resolution
Targeted correction. Treat absence as an explicit branch, create or apply the attribute only through the owning storage-tiering API, and avoid fabricating metadata in alternate streams or reparse data.
Acceptance criterion. The caller handles objects with and without the attribute, the intended tiered object reports consistent metadata, and path replacement cannot change the interpretation.
Technical references
References for ERROR_ATTRIBUTE_NOT_PRESENT on the deployed platform version.
- Microsoft Open Specifications: HRESULT values — defines the status namespace used.
- Microsoft: HRESULT facility extraction — documents the API or lifecycle behind this condition.
- Microsoft: file management information classes — provides ABI, implementation, or protocol context.
- Microsoft: storage tiers overview — supports the portability and verification limits.
Looking for a different code? Search another status or error code.