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