Protocols/MSNP/Reference/Error List
MSNP Protocol |
Introduction • Terms • Clients |
Reference |
Error List • Commands • Relying Party Suite • Spotlife |
Services |
XMPP • HTTP Gateway • Tabs • Activities |
Documentation |
Development Tools • MSNP Grid |
Polygamy • URLs used by MSN |
Documents |
Protocol Versions |
Version 21 |
Version 18 |
Version 16 |
Version 15 |
Version 14 |
Version 13 |
Version 12 |
Version 11 |
Version 9 |
Version 8 |
Version 2 |
MSNC |
Introduction • P2P • Object Descriptor • Display Pictures • File Transfer |
Scenarios |
Microsoft Messenger for Mac |
MSNP on WebTV (MSNTV) |
Contents: | 200s 300s 400s 500s 600s 700s 800s 900s |
---|
200s
200
Invalid Syntax Never before encountered.
201
Invalid parameter Sent if the command has a parameter that is considered invalid by the server. Setting your status to FLN would be an example.
>>> CHG 19 FLN 0\r\n <<< 201 19\r\n
Also sent if you try to ADD an invalid email address.
>>> ADD 20 FL a@b a@b\r\n <<< 201 20\r\n
205
Invalid principal Sent if you try to ADD a non-existent, but valid, account name.
>>> ADD 21 AL non_existent_account@passport.com non_existent_account@passport.com\r\n <<< 205 21\r\n
With MSNP10 and above, this has changed to error 208.
206
Domain name missing When you try logging in with a name like: "81.153.72.241@" with no domain.
207
Already logged in If the client sends a USR after already logging in, this error will be sent in response.
>>> USR 20 TWN I example@passport.com\r\n <<< 207 20\r\n >>> USR 21 TWN S t=53*1hAu8ADuD3TEwdXoOMi08sD . . . \r\n <<< 207 21\r\n
208
Invalid principal Sent from the switchboard in reply to a CAL with an invalid account name.
>>> CAL 2 @@a\r\n <<< 208 2\r\n
Also sent by the notification server if you try to ADC (MSNP10 and above) a non-existent, but valid, Passport account.
>>> ADC 453 FL N=this_account_doesnt_exist@hotmail.com F=this_account_doesnt_exist@hotmail.com\r\n <<< 208 453\r\n
209
Nickname change illegal Sent in reply to REA when there is a blocked word/phrase in the new nickname or when the Passport has not yet been confirmed.
>>> REA 18 principal@passport.com look%20msn\r\n <<< 209 18\r\n
210
Principal list full Sent in response to an ADD/ADC command if the list in question is already full. The principal will not be added. Currently (as of October 2005), the limit is 600 principals on FL and 1000 on RL.
>>> ADD 23 FL principal@passport.com principal@passport.com 0\r\n <<< 210 23\r\n
213
Invalid rename request? Don't know exactly how to describe this, but I got this error when attempting to rename a telephone number. (eca0d232-2d18-4b30-9200-63d94add303d = tel:+131123456789)
>>> SBP 1102 eca0d232-2d18-4b30-9200-63d94add303d MFN banaan <<< 213 1102
215
Principal already on list Sent if you try to ADD a principal to a list, but the principal is already in that list.
>>> ADD 26 AL principal@passport.com principal@passport.com\r\n <<< ADD 26 AL 824 principal@passport.com principal@passport.com\r\n >>> ADD 27 AL principal@passport.com principal@passport.com\r\n <<< 215 27\r\n
Also sent if you try to ADD a principal to your FL in a group that the principal is already in.
>>> ADD 28 FL principal@passport.com principal@passport.com 2\r\n <<< ADD 28 825 FL principal@passport.com principal@passport.com 2\r\n >>> ADD 29 FL principal@passport.com principal@passport.com 2\r\n <<< 215 29\r\n
Also sent if you try to invite (CAL) a principal into a switchboard session that has already been invited and/or is already present.
>>> CAL 5 example@passport.com\r\n <<< CAL 5 RINGING 286195\r\n >>> CAL 6 example@passport.com\r\n <<< 215 6\r\n
216
Principal not on list Sent in reply to REMs that try to remove principals that are not in the list. Also sent if you try to remove non-existent or invalid account names.
>>> REM 14 FL principal_not_in_list@msn.com\r\n <<< 216 14\r\n
This error is also sent in reply to invitations to the switchboard (CALs) to principals that either have you in their BL or have opted to 'block all others' (BLP BL). This is only sent when the principal is online. If the principle is offline, you will receive 217 instead. As of January 2004, error 217 is returned in this instance!
>>> CAL 2 example@passport.com\r\n <<< 216 2\r\n
Also sent in reply to renaming principals that are not in any of your lists.
>>> REA 48 random_principal@randomdomain.com nickname\r\n <<< 216 48\r\n
217
Principal not online This error is sent in reply to invitations to the switchboard (CALs) to principals that are currently either offline or appearing offline. This error will also be sent in reply to invitations to non-existent account names.
>>> CAL 2 myname@msn.com\r\n <<< 217 2\r\n >>> CAL 3 non_existent@passport.com\r\n <<< 217 3\r\n
218
Already in mode Sent in reply to GTC or BLP if it is already in that mode.
>>> GTC 15 A\r\n <<< GTC 15 150 A\r\n >>> GTC 16 A\r\n <<< 218 16\r\n
>>> BLP 17 BL\r\n <<< BLP 17 151 BL\r\n >>> BLP 18 BL\r\n <<< 218 18\r\n
219
Principal is in the opposite list Send in reply to an ADD that causes the same principal to be in the BL and the AL at the same time. Obviously, that cannot be possible, and the principal will not be added.
>>> ADD 15 AL example@passport.com example@passport.com\r\n <<< ADD 15 AL 108 example@passport.com Mike\r\n >>> ADD 16 BL example@passport.com example@passport.com\r\n <<< 219 16\r\n
223
Too many groups Sent if you try to add a group (ADG) so that you have more than 30 groups (the maximum). The group with the ID of zero counts toward the limit.
>>> ADG 38 thirtyfirst%20group 0\r\n <<< 223 38\r\n
224
Invalid group Sent if you try to ADD a principal to your FL with a non-existent group ID. Also sent in reply to REMs to non-existent groups. Also sent in reply if you try to remove (RMG) or rename (REG) a non-existent group.
>>> RMG 24 15\r\n <<< RMG 24 12065 15\r\n >>> ADD 25 FL example@passport.com example@passport.com 15\r\n <<< 224 25\r\n >>> REM 26 FL example@passport.com 15\r\n <<< 224 26\r\n >>> RMG 27 15\r\n <<< 224 27\r\n >>> REG 28 15 New%20Name 0\r\n <<< 224 28\r\n
225
Principal not in group Sent if you try to remove (REM) a principal from a group that they are not currently in.
>>> REM 27 FL example@passport.com 3\r\n <<< 225 27\r\n
227
Group not empty Sent if you try to remove (RMG) a group that is not empty.
>>> RMG 28 15\r\n <<< 226 28\r\n
228
Group with same name already exists Sent if you try to rename (REG) a group and a group on your Hotmail (not Messenger) contact list already exists with the same name.
>>> REG 25 1 New%20Name 0\r\n <<< 228 25\r\n
The official client reports:
You have already used this name for another group in your Messenger or Hotmail contact list. Please choose another name.
However, it will let you create a new group with the same name, then if you delete the group on Messenger, it disappears from Hotmail too!
229
Group name too long Sent if you try to add a group (ADG) with more than 61 bytes in the name.
>>> ADG 50 this%20group's%20name%20is%20sixty%20two%20bytes%20in%20length 0\r\n <<< 229 50\r\n
230
Cannot remove group zero Sent if you try to remove (RMG) the group with the ID of zero.
>>> RMG 28 0\r\n <<< 230 28\r\n
231
Invalid group Never before encountered.
240
Empty domain If you try to add an empty group of users (domain) in the ADL command, you'll receive the 200 error and get disconnected.
>>> ADL TrId xxx <ml> <d n="hotmail.com"> <c n="user" l="3" t="1" /> </d> <d n="yahoo.fr" /> </ml> <<< 240 TrId
280
Switchboard failed Never before encountered.
281
Transfer to switchboard failed Never before encountered.
282
P2P Error? Sent if you goof up with Protocols/MSNP/MSNSLP. Check whether your MSG length argument is correct, you can screw up pretty badly and still get the ACK, but if this argument is wrong you'll get 282 no matter what else (note that the length consists of ANYTHING sent after the CRLF in that message).
300s
300
Required field missing Never before encountered.
302
Not logged in Never before encountered.
400s
402
Error accessing contact list Indicates that the servers are experiencing problems. When signing in, the client will give a "You cannot sign in because your contact list is currently unavailable" message. When trying to add/remove contacts from any list the client will give "We cannot update your address book at this time. Please try making this change again later."
Should be treated as a generic contact list error.
403
Error accessing contact list Indicates that the servers are experiencing problems. When signing in, the client will give a "You cannot sign in because your contact list is currently unavailable" message. When trying to add/remove contacts from any list, the client will give "We cannot update your address book at this time. Please try making this change again later."
Also returned when using bad format for REM (like using email for FL or N= prefix, etc.).
Should be treated as a generic contact list error.
420
Invalid Account Permissions This is received when a non Beta Tester user tries to login to Messenger Beta. It is also received in response to a CVR command with an unofficial client name or version.
500s
500
Internal server error When the servers are down, this might be sent in reply to your USR command to the NS containing your ticket. The official client interprets this as "Service Temporarily Unavailable". This error might also be sent if your account has banned.
>>> USR 4 TWN S t=53*1hAu8ADuD3TEwdXoOMi08sD . . . \r\n <<< 500 4\r\n
501
Database server error Never before encountered.
502
Command disabled Sent if you try to use a command associated with an MSN Messenger feature that no longer exists.
>>> FND 3 fname=Bill lname=Gates city=* state=* country=US\r\n <<< 502 3\r\n
510
File operation failed Never before encountered.
511
Banned User account you are attempting to connect with is banned.
520
Memory allocation failed Never before encountered.
540
Challenge response failed Sent in response to a QRY that is invalid. The server will close the connection after sending the error.
<<< CHL 0 15570131571988941333\r\n >>> QRY 10 msmsgs@msnmsgr.com 32\r\n 4f2f5a91b72102cd28355e9fc9000d6e <<< 540 10\r\n
600s
600
Server is busy Never before encountered.
601
Server is unavailable Can be sent in reply to the initial USR to the NS if the server is somehow unavailable.
>>> USR 10 TWN I example@passport.com\r\n <<< 601 10\r\n
602
Peer nameserver is down Never before encountered.
603
Database connection failed Can be sent in reply to the SYN command when the NS server is having some sort of problems.
>>> SYN 10 0 0\r\n <<< 603 10\r\n
604
Server is going down Never before encountered.
605
Server unavailable Never before encountered.
700s
700
Could not create connection Never before encountered.
710
Bad CVR parameters sent Sent in reply to a CVR if you send an invalid LCID.
>>> CVR 1 0x0809 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@passport.com\r\n <<< 710 1\r\n
711
Write is blocking Never before encountered.
712
Session is overloaded Never before encountered.
713
Calling too rapidly When the client repeatedly calls someone who is offline or blocking them, this error message will be sent in response to the commands that the server rejects.
>>> CAL 5 blocking_you@passport.com\r\n <<< 216 5\r\n >>> CAL 5 blocking_you@passport.com\r\n <<< 216 5\r\n >>> CAL 5 blocking_you@passport.com\r\n <<< 216 5\r\n >>> CAL 5 blocking_you@passport.com\r\n <<< 216 5\r\n >>> CAL 5 blocking_you@passport.com\r\n <<< 216 5\r\n >>> CAL 5 blocking_you@passport.com\r\n <<< 713 5\r\n
714
Too many sessions Never before encountered.
715
Not expected Sent in response to a PRP setting an invalid phone type of three or less characters.
>>> PRP 30 PHV 555-0690\r\n <<< 715 30\r\n
Also sent in response to a change of display name (REA) on an unverified Passport account.
>>> REA 31 me@passport.com newname\r\n <<< 715 31\r\n
And when logging in, when you swap the GCF and the SYN order.
>>> GCF 12 Shields.xml >>> SYN 13 0 0 <<< 715 12
717
Bad friend file Never before encountered.
731
Not expected Sent in response to a badly formatted CVR.
>>> CVR 2 foo\r\n <<< 731 2\r\n <o> Server Closes Connection\r\n
800s
800
Changing too rapidly When the client tries to change the display name (REA) too rapidly, this error message will be sent in response to the commands that the server rejects. This does not affect renaming other principals.
>>> REA 100 me@passport.com NAME\r\n <<< REA 100 2000 me@passport.com NAME\r\n >>> REA 101 me@passport.com NAME\r\n <<< REA 101 2001 me@passport.com NAME\r\n >>> REA 102 me@passport.com NAME\r\n <<< REA 102 2002 me@passport.com NAME\r\n >>> REA 103 me@passport.com NAME\r\n <<< REA 103 2003 me@passport.com NAME\r\n >>> REA 104 me@passport.com NAME\r\n <<< 800 104\r\n
Also when the client tries to change the status (CHG) too rapidly.
>>> CHG 105 NLN 0\r\n <<< CHG 105 NLN 0\r\n >>> CHG 106 HDN 0\r\n <<< CHG 106 HDN 0\r\n >>> CHG 107 NLN 0\r\n <<< CHG 107 NLN 0\r\n >>> CHG 108 HDN 0\r\n <<< CHG 108 HDN 0\r\n >>> CHG 109 NLN 0\r\n <<< 800 109\r\n
Also when requesting too many switchboard sessions. You can request up to 8 switchboard sessions in any 60-second period. Failed requests (i.e. requests that receive this error in reply) also count towards this limit.
>>> XFR 126 SB\r\n <<< 800 126\r\n
900s
910
Server too busy When the servers are busy, this might be sent in reply to your USR command to the NS containing your ticket.
>>> USR 4 TWN S t=53*1hAu8ADuD3TEwdXoOMi08sD . . . \r\n <<< 910 4\r\n
911
Server is busy Sent in response to some invalid formats of the USR command to the DS or NS. Also sent if the account name is invalid or non-existent.
>>> USR 3 TWN S example@passport.com\r\n <<< 911 3\r\n
>>> USR 3 TWN I passport.com\r\n <<< 911 3\r\n
Sent in response to an invalid ticket sent in the second USR command to the NS.
>>> USR 4 TWN S t=some_invalid_value\r\n <<< 911 4\r\n
Also sent in response to problems authenticating with the switchboard with USR or ANS.
>>> USR 1 myname_123@hotmail.com 486979.1047702516.105\r\n <<< 911 1\r\n
>>> ANS 1 myname_123@hotmail.com 849102291.520491932 11752098\r\n <<< 911 1\r\n
912
Server too busy Never before encountered.
913
Not allowed when hidden Sent in reply to commands that are not allowed in the HDN status. The only known command that is prohibited when hidden (before MSNP13) is XFR.
>>> XFR 13 SB\r\n <<< 913 13\r\n
914
Server unavailable Never before encountered.
915
Server unavailable Never before encountered.
916
Server unavailable Never before encountered.
917
Authentication failed Never before encountered.
918
Server too busy Never before encountered.
919
Server too busy Never before encountered.
920
Not accepting new principals Never before encountered.
921
Server too busy When the servers are busy, this might be sent in reply to your USR command to the NS containing your ticket.
>>> USR 4 TWN S t=53*1hAu8ADuD3TEwdXoOMi08sD . . . \r\n <<< 921 4\r\n
922
Server too busy Never before encountered.
923
Kids' Passport without parental consent Sent in reply to the second USR to the NS if client is logging in with a Kids' Passport without parental consent to chat online.
>>> USR 4 TWN S t=53*1hAu8ADuD3TEwdXoOMi08sD . . . \r\n <<< 923 4\r\n
This is also sent in reply to a badly formatted ticket in the second USR. (eg, you did not html decode the ticket properly).
924
Passport account not yet verified This sometimes happens after attempting to change display name on a recently created passport account.
928
Bad ticket Sent in reply to the second USR to the NS if your ticket is invalid. Mostly seen if you don't handle redirections properly with the login server connection and use an @msn or @hotmail account.
>>> USR 4 TWN S invalid_ticket\r\n <<< 928 4\r\n
928 errors will also be seen if you didn't HTML entity decode the token received using the new MSNP13 authentication protocol. Main offender I've seen is & amp; - this needs to become a plain ol' '&' before you can send it as part of the final USR
931
Account not on this server Sent in reply to the first USR to the NS if your account is not on that server. It will happen when you cache the NS server (you don't use the dispatch server everytime) and msn has moved the account from the cached NS.
>>> USR 3 TWN I unavailable@account.com\r\n <<< 931 3\r\n