Remote Desktop Client Troubleshooting: Disconnect Codes and Reasons
Summary
This article contains most of the current Remote Desktop Client disconnect codes and reasons. Please see parent article [[articles: Remote Desktop Services RDS Logon Connectivity Overview]] for additional information.
More Information
The RDP client disconnect codes are written to the 'Microsoft-Windows-TerminalServices-RDPClient/Operational' event login 'Applications and Services Logs/Microsoft/Windows' in Event Viewer. Not all codes are enumerable from the COM method shown below. Additionally, some of the disconnect codes returned are extended codes. If the disconnect code is not found in the Primary Disconnect Reasons table, see the Extended Disconnect Reasons table. When troubleshooting client-side connections, be aware that depending on a configuration such as encryption and security level, the client may attempt connection multiple times and disconnect before the final connection is made.
Script
The following snippet is a PowerShell command to query COM MSTscAx with a decimal disconnect code ID. If the disconnect code is found the description will be returned.
NOTE: When running the command below, 'An internal error has occurred.'. This is a generic return code description when the disconnect code in is not found and return description is not valid.
# powershell script to return description of rds client disconnect codes in decimal format (not hex)
Param(
[parameter(Position=0,Mandatory=$true,HelpMessage="Enter the disconnect reason code in decimal from client side rds trace")]
[string] $disconnectReason,
[string] $extendedReason = 0
)
$mstsc = New-Object -ComObject MSTscAx.MsTscAx write-host "description: $($mstsc.GetErrorDescription($disconnectReason,$extendedReason))"
Example Event from Event Log
Below is an example event log entry event ID 1026 of an RDP client session disconnect event (event code 263 which is no error).
Log Name: Microsoft-Windows-TerminalServices-RDPClient/Operational
Source: Microsoft-Windows-TerminalServices-ClientActiveXCore
Date: 5/3/2017 7:40:58 AM
Event ID: 1026
Task Category: Connection Sequence
Level: Information
Keywords:
User: client-machine\jason
Computer: client-machine
Description:
RDP ClientActiveX has been disconnected (Reason= 263)
Event Xml:
<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event">
<System>
<Provider Name="Microsoft-Windows-TerminalServices-ClientActiveXCore" Guid="{28AA95BB-D444-4719-A36F-40462168127E}" />
<EventID>1026</EventID>
<Version>0</Version>
<Level>4</Level>
<Task>101</Task>
<Opcode>11</Opcode>
<Keywords>0x4000000000000000</Keywords>
<TimeCreated SystemTime="2017-05-03T11:40:58.058887000Z" />
<EventRecordID>61070</EventRecordID>
<Correlation ActivityID="{3371E543-77B1-41BA-8835-674829620000}" />
<Execution ProcessID="14296" ThreadID="15212" />
<Channel>Microsoft-Windows-TerminalServices-RDPClient/Operational</Channel>
<Computer>client-machine</Computer>
<Security UserID="" />
</System>
<EventData>
<Data Name="Name">Disconnect Reason</Data>
<Data Name="Value">263</Data>
<Data Name="CustomLevel">Info</Data>
</EventData>
</Event>
Primary Disconnect Reasons
Code | Reason |
0 | No error |
1 | User-initiated client disconnect. |
2 | User-initiated client logoff. |
3 | Your Remote Desktop Services session has ended, possibly for one of the following reasons: The administrator has ended the session. An error occurred while the connection was being established. A network problem occurred. For help solving the problem, see "Remote Desktop" in Help and Support. |
260 | Remote Desktop can't find the computer "". This might mean that "" does not belong to the specified network. Verify the computer name and domain that you are trying to connect to. |
262 | This computer can't connect to the remote computer. Your computer does not have enough virtual memory available. Close your other programs, and then try connecting again. If the problem continues, contact your network administrator or technical support. |
264 | This computer can't connect to the remote computer. The two computers couldn't connect in the amount of time allotted. Try connecting again. If the problem continues, contact your network administrator or technical support. |
266 | The smart card service is not running. Please start the smart card service and try again. |
516 | Remote Desktop can't connect to the remote computer for one of these reasons: 1) Remote access to the server is not enabled 2) The remote computer is turned off 3) The remote computer is not available on the network Make sure the remote computer is turned on and connected to the network, and that remote access is enabled. |
522 | A smart card reader was not detected. Please attach a smart card reader and try again. |
772 | This computer can't connect to the remote computer. The connection was lost due to a network error. Try connecting again. If the problem continues, contact your network administrator or technical support. |
778 | There is no card inserted in the smart card reader. Please insert your smart card and try again. |
1030 | Because of a security error, the client could not connect to the remote computer. Verify that you are logged on to the network, and then try connecting again. |
1032 | The specified computer name contains invalid characters. Please verify the name and try again. |
1034 | An error has occurred in the smart card subsystem. Please contact your helpdesk about this error. |
1796 | This computer can't connect to the remote computer. Try connecting again. If the problem continues, contact the owner of the remote computer or your network administrator. |
1800 | Your computer could not connect to another console session on the remote computer because you already have a console session in progress. |
2055 |
This computer can't connect to the remote computer. Check the user name, domain name and password and try again. |
2056 |
The remote computer disconnected the session because of an error in the licensing protocol. Please try connecting to the remote computer again or contact your server administrator. |
2308 | Your Remote Desktop Services session has ended. The connection to the remote computer was lost, possibly due to network connectivity problems. Try connecting to the remote computer again. If the problem continues, contact your network administrator or technical support. |
2311 | The connection has been terminated because an unexpected server authentication certificate was received from the remote computer. Try connecting again. If the problem continues, contact the owner of the remote computer or your network administrator. |
2312 | A licensing error occurred while the client was attempting to connect (Licensing timed out). Please try connecting to the remote computer again. |
2567 | The specified username does not exist. Verify the username and try logging in again. If the problem continues, contact your system administrator or technical support. |
2820 | This computer can't connect to the remote computer. An error occurred that prevented the connection. Try connecting again. If the problem continues, contact the owner of the remote computer or your network administrator. |
2822 | Because of an error in data encryption, this session will end. Please try connecting to the remote computer again. |
2823 | The user account is currently disabled and cannot be used. For assistance, contact your system administrator or technical support. |
2825 | The remote computer requires Network Level Authentication, which your computer does not support. For assistance, contact your system administrator or technical support. |
3079 | A user account restriction (for example, a time-of-day restriction) is preventing you from logging on. For assistance, contact your system administrator or technical support. |
3080 | The remote session was disconnected because of a decompression failure at the client side. Please try connecting to the remote computer again. |
3335 | As a security precaution, the user account has been locked because there were too many logon attempts or password change attempts. Wait a while before trying again, or contact your system administrator or technical support. |
3337 | The security policy of your computer requires you to type a password on the Windows Security dialog box. However, the remote computer you want to connect to cannot recognize credentials supplied using the Windows Security dialog box. For assistance, contact your system administrator or technical support. |
3590 | The client can't connect because it doesn't support FIPS encryption level. Please lower the server side required security level Policy, or contact your network administrator for assistance |
3591 | This user account has expired. For assistance, contact your system administrator or technical support. |
3592 | Failed to reconnect to your remote session. Please try to connect again. |
3593 | The remote PC doesn't support Restricted Administration mode. |
3847 | This user account's password has expired. The password must change in order to logon. Please update the password or contact your system administrator or technical support. |
3848 | A connection will not be made because credentials may not be sent to the remote computer. For assistance, contact your system administrator. |
4103 | The system administrator has restricted the times during which you may log in. Try logging in later. If the problem continues, contact your system administrator or technical support. |
4104 | The remote session was disconnected because your computer is running low on video resources. Close your other programs, and then try connecting again. If the problem continues, contact your network administrator or technical support. |
4359 | The system administrator has limited the computers you can log on with. Try logging on at a different computer. If the problem continues, contact your system administrator or technical support. |
4615 | You must change your password before logging on the first time. Please update your password or contact your system administrator or technical support. |
4871 | The system administrator has restricted the types of logon (network or interactive) that you may use. For assistance, contact your system administrator or technical support. |
5127 | The Kerberos sub-protocol User2User is required. For assistance, contact your system administrator or technical support. |
6919 | Remote Desktop cannot connect to the remote computer because the authentication certificate received from the remote computer is expired or invalid. In some cases, this error might also be caused by a large time discrepancy between the client and server computers. |
7431 | Remote Desktop cannot verify the identity of the remote computer because there is a time or date difference between your computer and the remote computer. Make sure your computer's clock is set to the correct time, and then try connecting again. If the problem occurs again, contact your network administrator or the owner of the remote computer. |
8711 | Your computer can't connect to the remote computer because your smart card is locked out. Contact your network administrator about unlocking your smart card or resetting your PIN. |
9479 | Could not auto-reconnect to your applications,please re-launch your applications |
9732 | Client and server versions do not match. Please upgrade your client software and then try connecting again. |
33554433 | Failed to reconnect to the remote program. Please restart the remote program. |
33554434 | The remote computer does not support RemoteApp. For assistance, contact your system administrator. |
50331649 | Your computer can't connect to the remote computer because the username or password is not valid. Type a valid user name and password. |
50331650 | Your computer can't connect to the remote computer because it can't verify the certificate revocation list. Contact your network administrator for assistance. |
50331651 | Your computer can't connect to the remote computer due to one of the following reasons: 1) The requested Remote Desktop Gateway server address and the server SSL certificate subject name do not match. 2) The certificate is expired or revoked. 3) The certificate root authority does not trust the certificate. Contact your network administrator for assistance. |
50331652 | Your computer can't connect to the remote computer because the SSL certificate was revoked by the certification authority. Contact your network administrator for assistance. |
50331653 | This computer can't verify the identity of the RD Gateway "". It's not safe to connect to servers that can't be identified. Contact your network administrator for assistance. |
50331654 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server address requested and the certificate subject name do not match. Contact your network administrator for assistance. |
50331655 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server's certificate has expired or has been revoked. Contact your network administrator for assistance. |
50331656 | Your computer can't connect to the remote computer because an error occurred on the remote computer that you want to connect to. Contact your network administrator for assistance. |
50331657 | An error occurred while sending data to the Remote Desktop Gateway server. The server is temporarily unavailable or a network connection is down. Try again later, or contact your network administrator for assistance. |
50331658 | An error occurred while receiving data from the Remote Desktop Gateway server. Either the server is temporarily unavailable or a network connection is down. Try again later, or contact your network administrator for assistance. |
50331659 | Your computer can't connect to the remote computer because an alternate logon method is required. Contact your network administrator for assistance. |
50331660 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server address is unreachable or incorrect. Type a valid Remote Desktop Gateway server address. |
50331661 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server is temporarily unavailable. Try reconnecting later or contact your network administrator for assistance. |
50331662 | Your computer can't connect to the remote computer because the Remote Desktop Services client component is missing or is an incorrect version. Verify that setup was completed successfully, and then try reconnecting later. |
50331663 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server is running low on server resources and is temporarily unavailable. Try reconnecting later or contact your network administrator for assistance. |
50331664 | Your computer can't connect to the remote computer because an incorrect version of rpcrt4.dll has been detected. Verify that all components for Remote Desktop Gateway client were installed correctly. |
50331665 | Your computer can't connect to the remote computer because no smart card service is installed. Install a smart card service and then try again, or contact your network administrator for assistance. |
50331666 | Your computer can't stay connected to the remote computer because the smart card has been removed. Try again using a valid smart card, or contact your network administrator for assistance. |
50331667 | Your computer can't connect to the remote computer because no smart card is available. Try again using a smart card. |
50331668 | Your computer can't stay connected to the remote computer because the smart card has been removed. Reinsert the smart card and then try again. |
50331669 | Your computer can't connect to the remote computer because the user name or password is not valid. Please type a valid user name and password. |
50331671 | Your computer can't connect to the remote computer because a security package error occurred in the transport layer. Retry the connection or contact your network administrator for assistance. |
50331672 | The Remote Desktop Gateway server has ended the connection. Try reconnecting later or contact your network administrator for assistance. |
50331673 | The Remote Desktop Gateway server administrator has ended the connection. Try reconnecting later or contact your network administrator for assistance. |
50331674 | Your computer can't connect to the remote computer due to one of the following reasons: 1) Your credentials (the combination of user name, domain, and password) were incorrect. 2) Your smart card was not recognized. |
50331675 | Remote Desktop can't connect to the remote computer "" for one of these reasons: 1) Your user account is not listed in the RD Gateway's permission list 2) You might have specified the remote computer in NetBIOS format (for example, computer1), but the RD Gateway is expecting an FQDN or IP address format (for example, computer1.fabrikam.com or 157.60.0.1). Contact your network administrator for assistance. |
50331676 | Remote Desktop can't connect to the remote computer "" for one of these reasons: 1) Your user account is not authorized to access the RD Gateway "" 2) Your computer is not authorized to access the RD Gateway "" 3) You are using an incompatible authentication method (for example, the RD Gateway might be expecting a smart card but you provided a password) Contact your network administrator for assistance. |
50331679 | Your computer can't connect to the remote computer because your network administrator has restricted access to this RD Gateway server. Contact your network administrator for assistance. |
50331680 | Your computer can't connect to the remote computer because the web proxy server requires authentication. To allow unauthenticated traffic to an RD Gateway server through your web proxy server, contact your network administrator. |
50331681 | Your computer can't connect to the remote computer because your password has expired or you must change the password. Please change the password or contact your network administrator or technical support for assistance. |
50331682 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server reached its maximum allowed connections. Try reconnecting later or contact your network administrator for assistance. |
50331683 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server does not support the request. Contact your network administrator for assistance. |
50331684 | Your computer can't connect to the remote computer because the client does not support one of the Remote Desktop Gateway's capabilities. Contact your network administrator for assistance. |
50331685 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server and this computer are incompatible. Contact your network administrator for assistance. |
50331686 | Your computer can't connect to the remote computer because the credentials used are not valid. Insert a valid smart card and type a PIN or password, and then try connecting again. |
50331687 | Your computer can't connect to the remote computer because your computer or device did not pass the Network Access Protection requirements set by your network administrator. Contact your network administrator for assistance. |
50331688 | Your computer can't connect to the remote computer because no certificate was configured to use at the Remote Desktop Gateway server. Contact your network administrator for assistance. |
50331689 | Your computer can't connect to the remote computer because the RD Gateway server that you are trying to connect to is not allowed by your computer administrator. If you are the administrator, add this Remote Desktop Gateway server name to the trusted Remote Desktop Gateway server list on your computer and then try connecting again. |
50331690 | Your computer can't connect to the remote computer because your computer or device did not meet the Network Access Protection requirements set by your network administrator, for one of the following reasons: 1) The Remote Desktop Gateway server name and the server's public key certificate subject name do not match. 2) The certificate has expired or has been revoked. 3) The certificate root authority does not trust the certificate. 4) The certificate key extension does not support encryption. 5) Your computer cannot verify the certificate revocation list. Contact your network administrator for assistance. |
50331691 | Your computer can't connect to the remote computer because a user name and password are required to authenticate to the Remote Desktop Gateway server instead of smart card credentials. |
50331692 | Your computer can't connect to the remote computer because smart card credentials are required to authenticate to the Remote Desktop Gateway server instead of a user name and password. |
50331693 | Your computer can't connect to the remote computer because no smart card reader is detected. Connect a smart card reader and then try again, or contact your network administrator for assistance. |
50331695 | Your computer can't connect to the remote computer because authentication to the firewall failed due to missing firewall credentials. To resolve the issue, go to the firewall website that your network administrator recommends, and then try the connection again, or contact your network administrator for assistance. |
50331696 | Your computer can't connect to the remote computer because authentication to the firewall failed due to invalid firewall credentials. To resolve the issue, go to the firewall website that your network administrator recommends, and then try the connection again, or contact your network administrator for assistance. |
50331698 | Your Remote Desktop Services session ended because the remote computer didn't receive any input from you. |
50331699 | The connection has been disconnected because the session timeout limit was reached. |
50331700 | Your computer can't connect to the remote computer because an invalid cookie was sent to the Remote Desktop Gateway server. Contact your network administrator for assistance. |
50331701 | Your computer can't connect to the remote computer because the cookie was rejected by the Remote Desktop Gateway server. Contact your network administrator for assistance. |
50331703 | Your computer can't connect to the remote computer because the Remote Desktop Gateway server is expecting an authentication method different from the one attempted. Contact your network administrator for assistance. |
50331704 | The RD Gateway connection ended because periodic user authentication failed. Try reconnecting with a correct user name and password. If the reconnection fails, contact your network administrator for further assistance. |
50331705 | The RD Gateway connection ended because periodic user authorization failed. Try reconnecting with a correct user name and password. If the reconnection fails, contact your network administrator for further assistance. |
50331707 | Your computer can't connect to the remote computer because the Remote Desktop Gateway and the remote computer are unable to exchange policies. This could happen due to one of the following reasons: 1. The remote computer is not capable of exchanging policies with the Remote Desktop Gateway. 2. The remote computer's configuration does not permit a new connection. 3. The connection between the Remote Desktop Gateway and the remote computer ended. Contact your network administrator for assistance. |
50331708 | Your computer can't connect to the remote computer, possibly because the smart card is not valid, the smart card certificate was not found in the certificate store, or the Certificate Propagation service is not running. Contact your network administrator for assistance. |
50331709 | To use this program or computer, first log on to the following website: <a href=""></a>. |
50331710 | To use this program or computer, you must first log on to an authentication website. Contact your network administrator for assistance. |
50331711 | Your session has ended. To continue using the program or computer, first log on to the following website: <a href=""></a>. |
50331712 | Your session has ended. To continue using the program or computer, you must first log on to an authentication website. Contact your network administrator for assistance. |
50331713 | The RD Gateway connection ended because periodic user authorization failed. Your computer or device didn't pass the Network Access Protection (NAP) requirements set by your network administrator. Contact your network administrator for assistance. |
50331714 | Your computer can't connect to the remote computer because the size of the cookie exceeded the supported size. Contact your network administrator for assistance. |
50331716 | Your computer can't connect to the remote computer using the specified forward proxy configuration. Contact your network administrator for assistance. |
50331717 | This computer cannot connect to the remote resource because you do not have permission to this resource. Contact your network administrator for assistance. |
50331718 | There are currently no resources available to connect to. Retry the connection or contact your network administrator. |
50331719 | An error occurred while Remote Desktop Connection was accessing this resource. Retry the connection or contact your system administrator. |
50331721 | Your Remote Desktop Client needs to be updated to the newest version. Contact your system administrator for help installing the update, and then try again. |
50331722 | Your network configuration doesn't allow the necessary HTTPS ports. Contact your network administrator for help allowing those ports or disabling the web proxy, and then try connecting again. |
50331723 | We're setting up more resources, and it might take a few minutes. Please try again later. |
50331724 | The user name you entered does not match the user name used to subscribe to your applications. If you wish to sign in as a different user please choose Sign Out from the Home menu. |
50331725 | Looks like there are too many users trying out the Azure RemoteApp service at the moment. Please wait a few minutes and then try again. |
50331726 | Maximum user limit has been reached. Please contact your administrator for further assistance. |
50331727 | Your trial period for Azure RemoteApp has expired. Ask your admin or tech support for help. |
50331728 | You no longer have access to Azure RemoteApp. Ask your admin or tech support for help. |
Extended Disconnect Reasons
Code | Reason |
0 | No error. |
1 | Extended Reason: Your Remote Desktop Services session has ended. Your network administrator might have ended the connection. Try connecting again, or contact technical support for assistance. |
2 | Extended Reason: Your Remote Desktop Services session has ended. You have logged off the remote computer. Your network administrator or another user might have ended your session. Try connecting again, or contact technical support for assistance. |
3 | Extended Reason: Your Remote Desktop Services session ended because the remote computer didn't receive any input from you. |
4 | Extended Reason: The remote session ended because the total login time limit was reached. This limit is set by the server administrator or by network policies. |
5 | Extended Reason: Your Remote Desktop Services session has ended. Another user connected to the remote computer, so your connection was lost. Try connecting again, or contact your network administrator or technical support group. |
6 | Extended Reason: The connection was disconnected because the remote computer is low on memory. |
7 | Extended Reason: This computer can't connect to the remote computer. Try connecting again. If the problem continues, contact the owner of the remote computer or your network administrator. |
8 | Extended Reason: The client could not establish a connection to the remote computer. The most likely causes for this error are: 1) Remote connections might not be enabled at the remote computer. 2) The maximum number of connections was exceeded at the remote computer. 3) A network error occurred while establishing a connection. 4) The remote computer might not support the required FIPS security level. Please lower the client side required security level Policy, or contact your network administrator for assistance. |
9 | Extended Reason: The connection was denied because the user account is not authorized for remote login. |
256 | Extended Reason: The remote session was disconnected because there was an internal error in the remote computer's licensing protocol. |
257 | Extended Reason: The remote session was disconnected because there are no Remote Desktop License Servers available to provide a license. Please contact the server administrator. |
258 | Extended Reason: The remote session was disconnected because there are no Remote Desktop client access licenses available for this computer. Please contact the server administrator. |
259 | Extended Reason: The remote session was disconnected because the remote computer received an invalid licensing message from this computer. |
260 | Extended Reason: The remote session was disconnected because the Remote Desktop client access license stored on this computer has been modified. |
261 | Extended Reason: The remote session was disconnected because the Remote Desktop client access license stored on this computer is in an invalid format. |
262 | Extended Reason: The remote session was disconnected because there were network problems during the licensing protocol. Please try connecting to the remote computer again. |
263 | Extended Reason: The remote session was disconnected because the client prematurely ended the licensing protocol. |
264 | Extended Reason: The remote session was disconnected because a licensing message was incorrectly encrypted. |
265 | Extended Reason: The remote session was disconnected because the local computer's client access license could not be upgraded or renewed. Please contact the server administrator. |
266 | Extended Reason: The remote session was disconnected because the remote computer is not licensed to accept remote connections. Please contact the server administrator. |
267 | Extended Reason: The remote session was disconnected because license store creation failed with access denied. Please run the remote desktop client with elevated privileges. |
1024 | Extended Reason: Remote Desktop Connection could not find the destination computer. This can happen if the computer name is incorrect or the computer is not yet registered with RD Connection Broker. Try connecting again, or contact your network administrator. |
1026 | Extended Reason: An error occurred while Remote Desktop Connection was loading the destination computer. Try connecting again, or contact your network administrator. |
1028 | Extended Reason: An error occurred while Remote Desktop Connection was redirecting to the destination computer. Try connecting again, or contact your network administrator. |
1029 | Extended Reason: Couldn't connect to the remote computer (there was a problem setting up the virtual machine). Try connecting again, or contact your network administrator for help. |
1030 | Extended Reason: An error occurred while Remote Desktop Connection was starting the virtual machine. Try connecting again, or contact your network administrator. |
1031 | Extended Reason: Windows can't find the IP address of the destination virtual machine. This can happen if the virtual machine doesn't have Hyper-V enlightenments and the name of the virtual machine doesn't match the computer name in Windows. Contact your network administrator for assistance. |
1032 | Extended Reason: There are no available computers in the pool. Try connecting again, or contact your network administrator. |
1033 | Extended Reason: Connection processing has been canceled. Try connecting again, or contact your network administrator. |
1040 | Extended Reason: Your computer can't connect to the remote computer because the Connection Broker couldn't validate the settings specified in your RDP file. Contact your network administrator for assistance. |
1041 | Extended Reason: A timeout error occurred while Remote Desktop Connection was starting the virtual machine. Try connecting again, or contact your network administrator. |
1042 | Extended Reason: A session monitoring error occurred while Remote Desktop Connection was starting the virtual machine. Try connecting again, or contact your network administrator. |
4339 | Extended Reason: The remote computer does not support RemoteApp. For assistance, contact your system administrator. |
4498 | Extended Reason: The remote session was disconnected because of a decryption error at the server. Please try connecting to the remote computer again. |