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