| Previous | Next |
| ERROR_DS_CANT_REPLACE_HIDDEN_REC | ERROR_DS_BUILD_HIERARCHY_TABLE_FAILED |
ERROR_DS_BAD_HIERARCHY_FILE
The hierarchy file is invalid.
ERROR_DS_BAD_HIERARCHY_FILE is Win32 error 8425 (0x000020E9) and concerns the directory hierarchy file used by a legacy directory or address-book operation.
What to verify
Verify whether the hierarchy file is syntactically valid and consistent with the expected directory structure. Check file path, size, and checksum, format or version header, and operation that produced the file.
Likely causes
- the file is truncated or corrupt.
- the file belongs to another version or environment.
- manual editing broke its format.
- storage or transfer changed its contents.
Troubleshooting steps
- Collect file path, size, and checksum.
- Record format or version header.
Handling, retry, and recovery
Regenerate the hierarchy file from authoritative directory data or restore a matching copy; do not repair unknown structure by guesswork.
Related errors
ERROR_DS_BUILD_HIERARCHY_TABLE_FAILED occurs while constructing the in-memory table, whereas this code identifies an invalid input file
Example
A migration imports a hierarchy file copied in text mode and line endings or bytes are altered. Regenerating it in the supported binary path resolves parsing.
References
Looking for a different code? Search another status or error code.