USMT Error Codes
I was recently configuring the User State Migration Tool for a customer’s MDT server when, during the testing phase, the USMT began failing with an error code (‘return code’ or ‘rc’ when you read the MDT log files). I searched the USMT documentation on TechNet looking for the explanation of what the error code meant, only to discover that I could not find any information at all.
So, after a bit of asking around internally at Microsoft, I have managed to obtain the below list of error codes. I should point out though that this list of error codes is only for version 3.01 of the USMT, I don’t know if there are differences for any past or future versions of the tool.
| Error code | Error text |
| 0 | USMT_SUCCESS |
| 1 | USMT_DISPLAY_HELP |
| 2 | USMT_MEMORY_FAIL |
| 3 | USMT_INVALID_PARAMETERS (Bad command line) |
| 4 | USMT_INVALID_STORE_LOCATION |
| 5 | USMT_NO_MORE_TOKEN |
| 6 | USMT_UNABLE_SET_SCRIPTFILES |
| 7 | USMT_UNABLE_GET_SCRIPTFILES (Can’t find XML file(s) specified in the command-line) |
| 8 | USMT_UNABLE_SET_STOREPATH |
| 9 | USMT_UNABLE_SET_USERS |
| 10 | USMT_UNABLE_FINDMIGUNITS |
| 11 | USMT_UNABLE_DOMIGRATION (A file is in use) |
| 12 | USMT_FAILED_MIGSTARTUP (Error in XML file ‘Bad XML’) |
| 13 | USMT_FAILED_SETMIGRATIONTYPE |
| 14 | USMT_FAILED_LOCALONLY |
| 15 | USMT_UNABLE_GET_WORKINGDIR |
| 16 | USMT_UNABLE_SETKEY |
| 17 | USMT_UNABLE_READKEY |
| 18 | USMT_TOO_LONG_KEYSTRING |
| 19 | USMT_UNABLE_SETCOMPRESSION |
| 20 | USMT_ERROR_INSUFFICIENT_RIGHTS |
| 21 | USMT_UNABLE_DELETE_STORE |
| 22 | USMT_UNABLE_SET_BENONADMIN |
| 23 | USMT_ERROR_INSUFFICIENT_STRINGBUFFER |
| 24 | USMT_ERROR_UNSUPPORTED_PLATFORM |
| 25 | USMT_ERROR_UNABLE_TOVERIFY_PLATFORM |
| 26 | USMT_UNABLE_SET_EFSMODE |
| 27 | USMT_INIT_ERROR |
| 28 | USMT_UNABLE_SET_LAC_LAE |
| 29 | USMT_ERROR_CORRUPTED_ENCRYPTED_STORE (Store is encrypted and no or invalid key has been specified) |
| 30 | USMT_ERROR_NO_INVALID_KEY (Store is only compressed but a key has been specified) |
| 31 | USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE |
| 32 | USMT_ERROR_LOGFILES_INSIDESTORE |
| 33 | USMT_INVALID_PLATFORM_FOR_TARGETXP |
| 34 | USMT_STORE_VALID_ONLY_FOR_XP |
| 35 | USMT_UNABLE_TO_READ_CONFIG_FILE |
| 36 | USMT_INVALID_CONFIG_FILE_FORMAT |
| 37 | USMT_ERROR_UNABLE_CREATE_LOGS |
| 38 | USMT_ERROR_USE_LAC |
| 39 | USMT_FAILED_TO_EXCLUDE_FOLDERS |
| 40 | USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG |
| 41 | USMT_STATUS_CANCELLED |
Most of the codes are pretty self-explanatory, but I have included some extra information for some of the more cryptic error messages.
This post was contributed by Daniel Oxley a consultant with Microsoft Services Spain