RegSvr32 exit codes documentation?

The exit codes are not documented. The documentation is here:

  • https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/regsvr32

However, the source code for a version REGSVR32.EXE is shipped with Visual Studio 2008. This gives its version as 4.0.0, so is not the same as the one shipped with windows, which reports version 6.

  • http://msdn.microsoft.com/en-us/library/ms177531(v=vs.90).aspx

A quick look shows these:

#define FAIL_ARGS   1 // Invalid Argument
#define FAIL_OLE    2 // OleInitialize Failed
#define FAIL_LOAD   3 // LoadLibrary Failed
#define FAIL_ENTRY  4 // GetProcAddress failed
#define FAIL_REG    5 // DllRegisterServer or DllUnregisterServer failed.

Reading the source code suggests that under no circumstances does it return any other code than the ones above and zero for success, which proves it isn't the same as the Windows one.

I suspect that the difference in return codes is if it gets as far as GetProcAddress, it then returns the exit code from the function it calls, instead of just always returning 5.

Ideally they would have made it use GetLastError to get a more useful exit code, but I suspect there are too many tools (e.g. third party install programs) which now depend on exit codes 2-4, and it is too late to change it.

Also see What do the various regsvr32 exit codes mean? on Raymond Chen's blog on MSDN.


Visual Studio used to ship with a MFC sample that was actually the source for the RegSvr32 utility and I remember going through that to harvest the exit codes:

FAIL_ARGS   1
FAIL_OLE    2
FAIL_LOAD   3
FAIL_ENTRY  4  // Not ERROR_TOO_MANY_OPEN_FILES but as expected "could not resolve 
               // DLLRegisterServer" as your using an invalid DLL
FAIL_REG    5

I can't find the sample, but if I Google for what I extracted there is this: http://web.archive.org/web/20140803013714/http://support.microsoft.com:80/kb/207132 which has matching codes so it looks like that KB demo code was also taken from RegSvr. Its trivial to work out the reasons behind each of the failure codes.