2.2.6 Remote Assistance Error Codes

The following Remote Assistance error codes MUST be returned as part of REMOTEDESKTOP_CTL_RESULT.

Return value/code	Description
0 SAFERROR_NOERROR	No errors occurred.
1 SAFERROR_NOINFO	An error occurred in a dependent component, and no detailed information is available.
3 SAFERROR_LOCALNOTERROR	Connection disconnected by local user.
4 SAFERROR_REMOTEBYUSER	Connection disconnected by remote user.
5 SAFERROR_BYSERVER	Connection dropped by remote computer.
6 SAFERROR_DNSLOOKUPFAILED	DNS resolution failed.
7 SAFERROR_OUTOFMEMORY	A memory allocation error occurred.
8 SAFERROR_CONNECTIONTIMEDOUT	A connection could not be established within the time-out period.
9 SAFERROR_SOCKETCONNECTFAILED	Connection to the remote computer failed.
11 SAFERROR_HOSTNOTFOUND	The remote computer is unreachable.
12 SAFERROR_WINSOCKSENDFAILED	A socket write failed.
14 SAFERROR_INVALIDIPADDR	The IP address given is not valid.
15 SAFERROR_SOCKETRECVFAILED	A socket read failed.
18 SAFERROR_INVALIDENCRYPTION	An encryption error occurred.
20 SAFERROR_GETHOSTBYNAMEFAILED	Winsock name resolution failed.
21 SAFERROR_LICENSINGFAILED	Remote Desktop Protocol: Basic Connectivity and Graphics Remoting [MS-RDPBCGR] licensing for the connection failed.
22 SAFERROR_ENCRYPTIONERROR	Remote Desktop Protocol: Basic Connectivity and Graphics Remoting [MS-RDPBCGR] encryption error occurred.
23 SAFERROR_DECRYPTIONERROR	A Remote Desktop Protocol decryption error occurred.
24 SAFERROR_INVALIDPARAMETERSTRING	An invalid Remote Assistance Connection String, as specified in [MS-RAI] section 2.2, was used.
25 SAFERROR_HELPSESSIONNOTFOUND	A Remote Assistance Connection String, as specified in [MS-RAI], section 2.2, was not found.
26 SAFERROR_INVALIDPASSWORD	An invalid password was used. This message is only used in version 1.
27 SAFERROR_HELPSESSIONEXPIRED	The Remote Assistance Connection String, as specified in [MS-RAI] section 2.2, has expired.
28 SAFERROR_CANTOPENRESOLVER	The remote computer could not resolve the session.
29 SAFERROR_UNKNOWNSESSMGRERROR	An unknown error occurred in the remote session manager.
30 SAFERROR_CANTFORMLINKTOUSERSESSION	The remote computer could not establish a connection to the specified user session.
32 SAFERROR_RCPROTOCOLERROR	A remote control protocol error occurred.
33 SAFERROR_RCUNKNOWNERROR	An unknown remote control error occurred.
34 SAFERROR_INTERNALERROR	An internal error occurred.
35 SAFERROR_HELPEERESPONSEPENDING	This code is not used.
36 SAFERROR_HELPEESAIDYES	This code is not used.
37 SAFERROR_HELPEEALREADYBEINGHELPED	The user is already under remote control.
38 SAFERROR_HELPEECONSIDERINGHELP	This code is not used.
40 SAFERROR_HELPEENEVERRESPONDED	The remote user did not accept the remote control request during the time-out period.
41 SAFERROR_HELPEESAIDNO	The remote user denied the remote control request.
42 SAFERROR_HELPSESSIONACCESSDENIED	The remote user does not have access to the specified connection string, as specified in [MS-RAI], section 2.2.
43 SAFERROR_USERNOTFOUND	The specified remote user was not found.
44 SAFERROR_SESSMGRERRORNOTINIT	A remote error occurred with the session manager.
45 SAFERROR_SELFHELPNOTSUPPORTED	Attempting to control your own session remotely is not supported.
47 SAFERROR_INCOMPATIBLEVERSION	An incompatible version was given. This message is only used in version 1.
48 SAFERROR_SESSIONNOTCONNECTED	This code is not used.
50 SAFERROR_SYSTEMSHUTDOWN	The remote system is shutting down.
51 SAFERROR_STOPLISTENBYUSER	The remote system has stopped listening for an incoming connection.
52 SAFERROR_WINSOCK_FAILED	A Winsock call has failed.
53 SAFERROR_MISMATCHPARMS	A parameter mismatch has occurred.
61 PASSWORDS_DONT_MATCH	An invalid password was used. This message is only used in version 2.
300 SAFERROR_SHADOWEND_BASE	Remote control of the user session has been terminated.
301 SAFERROR_SHADOWEND_CONFIGCHANGE	Remote control of the user session terminated due to a color depth or resolution change.
302 SAFERROR_SHADOWEND_UNKNOWN	Remote control of the user session has ended.