Interpreting Error Codes Returned by wsatConfig.exe

0

Operation was successful

None

1

Unexpected error

Contact Microsoft

2

An unexpected error occurred when trying to contact MSDTC to retrieve its security settings.

Ensure that the MSDTC service is not disabled, and address all problems listed in the returned Exception.

3

The account under which WsatConfig.exe ran did not have sufficient permissions to read the network security settings.

Execute WsatConfig.exe under an Administrator user account.

4

Enable "Network DTC Access" for MSDTC before trying to enable WS-AT support.

Enable "Network DTC Access" for MSDTC and re-run the utility.

5

The entered port was out of range. The value must be in the range of 1 to 65535.

Correct the -port:<portNum>

command line option as indicated in the error message.

6

An invalid endpoint certificate was specified on the command line. The certificate could not be found, or it did not pass verification.

Correct the -endpointCert command line option. Ensure that the certificate has a private key, is intended to be used for both ClientAuthentication and ServerAuthentication, is installed in the LocalMachine\MY certificate store, and is fully trusted.

7

An invalid accounts certificate was specified on the command line.

Correct the -accountsCerts command line option. The certificate specified was either improperly specified or it could not be found.

8

A default timeout was specified outside the range of 1 to 3600 seconds.

Enter a correct default timeout value as indicated.

10

An unexpected error occurred while trying to access the registry.

Check the error message and error code for actionable items

11

Cannot write to the registry.

Ensure that the key listed in the error message is capable of supporting registry access from the account WsatConfig.exe was executed under.

12

An unexpected error occurred while trying to access the certificate store.

Use the error code returned to map to the appropriate system error.

13

Configuration of http.sys failed. Cannot create a new HTTPS port reservation for MSDTC.

Use the error code returned to map to the appropriate system error.

14

Configuration of http.sys failed. Cannot remove previous HTTPS port reservation for MSDTC.

Use the error code returned to map to the appropriate system error.

15

Configuration of http.sys failed. A previous HTTPS port reservation already exists for the specified port.

Another application has already taken ownership of the specific port. Change to a different port or uninstall or reconfigure the current application.

16

Configuration of http.sys failed. Cannot bind the specified certificate to the port.

Use the error code returned in the error message to map to the appropriate system error

17

Configuration of http.sys failed. Cannot unbind the SSL certificate from the previous port.

Use the error code returned in the error message to map to the appropriate system error. If necessary, use httpcfg.exe or netsh.exe to remove the erroneous port reservations.

18

Configuration of http.sys failed. Cannot bind the specified certificate to the port because a previous SSL binding already exists.

Another application has already taken ownership of the specific port. Change to a different port or uninstall or reconfigure the current application.

19

Restarting MSDTC failed

Manually restart MSDTC if necessary. If the problem persists, contact Microsoft.

20

.NET Framework 3.0 is not installed on the remote machine, or is not installed correctly.

Install .NET Framework 3.0 on the machine.

21

Remote configuration failed due to the operation timing out.

The call to configure WS-AT on the remote machine should take longer than 90 seconds.

22

.NET Framework 3.0 is not installed on the remote machine, or is not installed correctly.

Install .NET Framework 3.0 on the machine.

23

Remote configuration failed due to an exception on the remote machine.

Check the error message for actionable items

26

An invalid argument was passed to WsatConfig.exe.

Check the command line for errors.

27

The -accounts command line option was invalid.

Correct the -accounts command line option to correctly specify a user account.

28

The -network command line option was invalid.

Correct the -network command line option to correctly specify "enable" or "disable".

29

The -maxTimeout command line option was invalid.

Correct the -maxTimeout command line option as indicated.

30

The -timeout command line option was invalid.

Correct the -timeout command line option as indicated.

31

The -traceLevel command line option was invalid.

Correct the -traceLevel command line option to specify a valid value from the followings,

• Off
  
  
• Error
  
  
• Critical
  
  
• Warning
  
  
• Information
  
  
• Verbose
  
  
• All
  
  

32

The -traceActivity command line option was invalid.

Correct the -traceActivity command line option by specifying either "enable" or "disable".

33

The -traceProp command line option was invalid.

Correct the -traceProp command line option by specifying either "enable" or "disable".

34

The -tracePII command line option was invalid.

Correct the -tracePII command line option by specifying either "enable" or "disable".

37

WsatConfig.exe was not able to determine the exact machine certificate. This might happen when there is more than one candidate, or when none exists.

Specify a certificate thumbprint or Issuer\SubjectName pair to correctly identify the exact certificate to configure.

38

The process or user does not have sufficient permissions to change the firewall configuration.

Execute WsatConfig.exe under an Administrator user account.

39

WsatConfig.exe encountered an error while updating the firewall configuration.

Check the error message for actionable items.

40

WsatConfig.exe is not able to give MSDTC Read access to the certificate's private key file

Execute WsatConfig.exe under an Administrator user account.

41

Either no installation of .NET Framework 3.0 could be found, or the version found does not match what the tool is capable of configuring.

Ensure .NET Framework 3.0 is correctly installed and only use the WsatConfig.exe tool that came with that version of .NET Framework 3.0 to configure WS-AT.

42

An argument was specified more than once on the command line.

Only specify each argument once when executing WsatConfig.exe.

43

WsatConfig.exe cannot update WS-AT settings if WS-AT is not enabled.

Specify -network:enable as an additional command line argument.

44

A required hotfix is missing and WS-AT cannot be configured until the hotfix is installed.

See the .NET Framework 3.0 release notes for instructions on installing the required hotfix.

45

The -virtualServer command line option was invalid.

Correct the -virtualServer command line option by specifying the network name of the cluster resource in which to configure.

46

An unexpected error occurred when trying to start the ETW trace session

Use the error code returned to map to the appropriate system error.

47

The process or user does not have sufficient permissions to enable the ETW trace session.

Execute WsatConfig.exe under an Administrator user account.

48

An unexpected error occurred while trying to start the ETW trace session.

Contact Microsoft.

49

Cannot create a new log file due to insufficient space on the %systemdrive%

Ensure that your %systemdrive% has adequate space for the log file.

51

An unexpected error occurred while trying to start the ETW trace session.

Contact Microsoft.

52

An unexpected error occurred while trying to start the ETW trace session.

Contact Microsoft.

53

Backup of the previous ETW session log file was unsuccessful.

Ensure that your %systemdrive% has adequate space for the log file and the backup of the previous log file (if any). Remove the previous log file manually if necessary.

55

An unexpected error occurred while trying to start the ETW trace session.

Contact Microsoft.

56

An unexpected error occurred while trying to start the ETW trace session.

Contact Microsoft.