| Previous | Next |
| ERROR_VC_DISCONNECTED | ERROR_EA_LIST_INCONSISTENT |
ERROR_INVALID_EA_NAME
The extended-attribute name is malformed
ERROR_INVALID_EA_NAME is a Win32 result associated with extended attributes and filesystem metadata., diagnosis should begin with the exact API, target object, and operation that produced it rather than with the message text alone.
What the result means
An extended-attribute name is invalid for the target filesystem or API. The practical meaning depends on the caller and on whether the affected object is local, remote, removable, policy-managed, or handled asynchronously. Diagnostics for it should retain its symbolic name, numeric value, and the operation name together.
What to check
- Validate allowed characters, namespace syntax, and maximum name length.
- Ensure the buffer uses the structure and encoding required by the API.
- Check for embedded null characters or incorrect byte counts.
- Compare behavior on the actual target filesystem because EA support varies.
Recommended handling
Reject the malformed attribute before issuing the filesystem request. Do not silently rewrite names unless the application owns and documents a normalization scheme.
Developer notes
Code handling this result should capture the failing API, resolved path or device identity, requested access, process identity, and the first observed error. After a call that reports it, read GetLastError() immediately because later cleanup or logging can overwrite the value. Retry it only when the specific condition is documented as transient, using a bounded delay and cancellation support.
References
- Microsoft: System error codes relevant to ERROR_INVALID_EA_NAME
- Microsoft: File management context for ERROR_INVALID_EA_NAME
Looking for a different code? Search another status or error code.