yellows111/msnp-wiki
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

0.2.0: The Winter Roll-up

Browse source 
i have basically touched every file help

* Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time.
* Rename passport (soap) to RST
* Formatting changes (many)
* Several corrections
* change git host because git.kevinthe.horse seems Dead
This commit is contained in:
Declan B. 2024-12-18 20:16:29 +00:00
parent 7488f2af43
commit ce7c3bee1c
Signed by: yellows111
SSH key fingerprint: SHA256:ynw5IJBU1pb7fZfHgLihKu9gHHA8FVpixZbB6IEB3r8
79 changed files with 437 additions and 488 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
docs/commands/ack.md
View file

@ -15,7 +15,7 @@ This command can not be sent from the client.
## As a response to MSG A
```
C: MSG 1 A 68
C: MSG 1 A 69
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
@ -39,7 +39,6 @@ S: ACK 2
```
C: ACK 3
```
Server disconnects client.
# Known changes

5
docs/commands/adc.md
View file

@ -154,14 +154,13 @@ S: 224 12
```
C: ADC 13 PL N=anotheruser@hotmail.com
```
Server disconnects client.
## Removed
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: ADC 14 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com
```
Server disconnects client.
## Asynchronous update

5
docs/commands/add.md
View file

@ -84,14 +84,13 @@ S: 224 10
```
C: ADD 11 RL anotheruser@hotmail.com anotheruser@hotmail.com
```
Server disconnects client.
## Removed
## Command removed
*Since [MSNP10](../versions/msnp10.md).*
```
C: ADD 12 FL anotheruser@hotmail.com anotheruser@hotmail.com
```
Server disconnects client.
## Asynchronous update

8
docs/commands/adg.md
View file

@ -55,7 +55,6 @@ C: ADG 3 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA 0
```
Server disconnects client.
## Without list versions
@ -89,7 +88,6 @@ C: ADG 7 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA
```
Server disconnects client.
### With group GUIDs
@ -121,7 +119,13 @@ C: ADG 11 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA
```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: ADG 12 Example%20Group
```
Server disconnects client.
# Known changes

12
docs/commands/ans.md
View file

@ -7,10 +7,11 @@ Used to join ("answer") a Switchboard session ("call").
The response of this command sent after the [IRO](iro.md) list has been sent.
# Client/Request
`ANS TrID my-handle cookie session-id`
`ANS TrID my-handle{;machine-guid} cookie session-id`
Where `my-handle` is the current user's handle.
In [MSNP16](../versions/msnp16.md), a UUID is appended after a semi-colon, which is your MPOP Machine ID.
Where `;machine-guid` is a bracketed Machine GUID. Added since [MSNP16](../versions/msnp16.md).
Where `cookie` is the `cookie` from the [RNG](rng.md) command sent to you.
@ -24,8 +25,11 @@ Where `OK` is always `OK`.
# Examples
## Answering a RNG
*NOTE: This has been line-breaked.
Lines beginning with .. followed by a space are continuations of the previous line.*
```
S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789 anotheruser@hotmail.com another%20user
S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789
.. anotheruser@hotmail.com another%20user
C: ANS 1 example@hotmail.com 123456789.123456789.123456789 987654321
S: IRO 1 1 1 anotheruser@hotmail.com another%20user
S: ANS 1 OK
@ -36,7 +40,6 @@ S: ANS 1 OK
```
C: ANS 2 example@hotmail.com bad data
```
Server disconnects client.
## Invalid context (Notification Server)
@ -44,7 +47,6 @@ Server disconnects client.
```
C: ANS 3 example@hotmail.com wrong server
```
Server disconnects client.
# Known changes

4
docs/commands/blp.md
View file

@ -36,12 +36,10 @@ S: 218 4
```
## Invalid argument
*NOTE: This is an assumption. The actual error code here is unknown.
It may also lead to an Instant Disconnection.*
```
C: BLP 5 CL
S: 201 5
```
Server disconnects client.
# Known changes
* [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode.

1
docs/commands/bpr.md
View file

@ -37,6 +37,7 @@ S: BPR 256 anotheruser@hotmail.com PHH 1%20(444)%20222%203333
```
C: BPR example@hotmail.com
```
Server disconnects client.
# Known changes
* [MSNP8](../versions/msnp8.md): Removed the user's handle when used in [SYN](syn.md).

1
docs/commands/bye.md
View file

@ -32,7 +32,6 @@ S: BYE anotheruser@hotmail.com 1
```
C: BYE 1
```
Server disconnects client.
# Known changes

10
docs/commands/cal.md
View file

@ -1,7 +1,7 @@
# Introduction
`CAL` is a command introduced with [MSNP2](../versions/msnp2.md).
It is a Switchboard Server command, without a response payload.
It is a Switchboard Server command, without either a request or response payload.
It invites ("calls") a user to a Switchboard session.
@ -43,14 +43,15 @@ C: CAL 4 anotheruser@hotmail.com
S: 217 4
```
## User does not allow you to contact them
*All instances that returned this have been changed to a 217. This response is deprecated.*
## That user does not allow you to contact them
*All instances that returned this have been changed to a 217.
This response is obsolete.*
```
C: CAL 5 anotheruser@hotmail.com
S: 216 5
```
## Rate limited
## You are being rate limited
```
C: CAL 6 anotheruser@hotmail.com
S: 217 6
@ -71,7 +72,6 @@ S: 713 11
```
C: CAL 12 anotheruser@hotmail.com
```
Server disconnects client.
# Known changes

6
docs/commands/chg.md
View file

@ -39,11 +39,12 @@ Also, all attempts to create a Switchboard session will fail automatically,
Exclusive to the `FLN` state, you are put in a very reduced state where you can
only recieve presence changes from other users and resynchronize your Lists.
You may be able to execute more commands, but doing so is Undefined Behaviour.
# Server/Response
`CHG TrID status {flags} {msnobj}`
The server may also send this Asynchronously, if it does, the TrID will be 0.
The server may also send this command asynchronously (at any time) with the `TrID` set to `0`.
# Examples
@ -78,7 +79,7 @@ S: CHG 3 BSY 268435500 %3Cmsnobj%20Creator%3D%22example%40hotmail.com%22
.. %20SHA1C%3D%22DBRJPnGb+wBYawENkdor1bOdYUs%3D%22%2F%3E
```
## Server Decides it wants you in Semi-Offline mode.
## Server asynchronously changes your status to Semi-offline.
```
S: CHG 0 FLN
```
@ -88,7 +89,6 @@ S: CHG 0 FLN
```
C: CHG 4 HOT
```
Server disconnects client.
# Known changes

13
docs/commands/chl.md
View file

@ -19,17 +19,17 @@ that is concatenated with the client's Private Key.
# Examples
## From server at any time
```
S: CHL 0 12345678901234567890
```
## Requested challenge
## Client-initiated challenge
```
C: CHL 1
S: CHL 1 12345678901234567890
```
## From server at any time
```
S: CHL 0 12345678901234567890
```
## Challenge timeout
```
S: CHL 0 12345678901234567890
@ -38,7 +38,6 @@ S: CHL 0 12345678901234567890
```
S: OUT
```
Server disconnects client.
# Known changes

7
docs/commands/cvq.md
View file

@ -17,7 +17,7 @@ Where `system-ver` is the major and minor version of the operating system, such
Where `system-arch` is the architecture of the processor that is used to run the client, usually `i386`.
Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`.
Where `requesting-library` is the name of the library that requested this CVQ, usually `MSMSGS` or `MSNMSGR`.
Where `client-version` is the current client's major, minor and patch version, should be in the format of "{M}M.m.pppp".
@ -55,7 +55,6 @@ S: CVQ 1 5.0.0537 5.0.0537 1.0.0863
.. http://download.microsoft.com/download/msnmessenger/install/5.0/w98nt42kmexp/en-us/setupdl.exe
.. http://messenger.microsoft.com
```
Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`.
## New
@ -66,7 +65,6 @@ S: CVQ 2 7.0.0813 7.0.0813 6.2.0205
.. http://msgr.dlservice.microsoft.com/download/5/d/9/5d9bb5b2-49c7-4890-94ab-d1d5e44a0e6d/Install_MSN_Messenger.exe
.. http://messenger.msn.com
```
Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`.
## Invalid client identification or version
@ -84,12 +82,11 @@ C: CVQ 5 0x1111 winnt 5.1 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: 710 5
```
## Invalid CVR
## Invalid parameters
```
C: CVQ 6 spaghetti
S: 731 6
```
Server disconnects client.
# Known changes

5
docs/commands/cvr.md
View file

@ -55,7 +55,6 @@ S: CVR 1 5.0.0537 5.0.0537 1.0.0863
.. http://download.microsoft.com/download/msnmessenger/install/5.0/w98nt42kmexp/en-us/setupdl.exe
.. http://messenger.microsoft.com
```
Client asks if user would like to update, and stays connected.
## Pre-login
@ -66,7 +65,6 @@ S: CVR 2 7.0.0813 7.0.0813 6.2.0205
.. http://msgr.dlservice.microsoft.com/download/5/d/9/5d9bb5b2-49c7-4890-94ab-d1d5e44a0e6d/Install_MSN_Messenger.exe
.. http://messenger.msn.com
```
Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`.
## Invalid client identification or version
@ -84,12 +82,11 @@ C: CVR 5 0x1111 winnt 5.1 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: 710 5
```
## Invalid CVR
## Invalid parameters
```
C: CVR 6 spaghetti
S: 731 6
```
Server disconnects client.
# Known changes

28
docs/commands/fln.md
View file

@ -9,13 +9,22 @@ It specifies that another user in your contact list has gone offline.
This command can not be sent from the client.
# Server/Response
`FLN {user-handle} {network-id}`
`FLN user-handle {network-id} {client-capabilities{:extended-client-capabilities}} {presence-icon-url}`
Where `user-handle` is the related user's handle.
Where `network-id` is the Network Identification Number that this user is from.
Added since [MSNP14](../versions/msnp14.md).
Where `client-capabilities` are the relevant user's new Client Capabilities.
Optional? Added since [MSNP14](../versions/msnp14.md).
Where `extended-client-capabilities` are the relevant user's Extended Client Capabilities.
Optional. Added since [MSNP16](../versions/msnp16.md).
Where `presence-icon-url` is an image that is rendered to this client that replaces the default user icon.
Optional. Added since [MSNP14](../versions/msnp14.md).
# Examples
## User goes offline
@ -26,10 +35,16 @@ Added since [MSNP14](../versions/msnp14.md).
S: FLN anotheruser@hotmail.com
```
### With Network IDs
### With Network IDs and Preesense Icon URLs and Client Capabilities
*Since [MSNP14](../versions/msnp14.md).*
```
S: FLN anotheruser@hotmail.com 1
S: FLN anotheruser@hotmail.com 1 0 http://example.com/interop/offline.png
```
### With Extended Client Capabilities
*Since [MSNP16](../versions/msnp16.md).*
```
S: FLN anotheruser@hotmail.com 1 0:0 http://example.com/interop/offline.png
```
## Invalid context
@ -37,8 +52,11 @@ S: FLN anotheruser@hotmail.com 1
```
C: FLN Hotmail
```
Server disconnects client.
# Known changes
* [MSNP14](../versions/msnp14.md): Added a new parameter that denotes the Network ID of the user that is now offline.
* [MSNP14](../versions/msnp14.md): Added several new parameters that denotes the following:
* Network ID of the user that is now offline.
* The new client capabilities of the user that is now offline.
* A way to override the default presense icon.
* [MSNP16](../versions/msnp16.md): Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.

2
docs/commands/fnd.md
View file

@ -51,7 +51,7 @@ C: FND 4 fname=Another lname=User city=* state=* country=*
S: 301 4
```
## Removed
## Command removed
```
C: FND 5 fname=Another lname=User city=* state=* country=US
S: 502 5

4
docs/commands/fqy.md
View file

@ -41,7 +41,7 @@ Where payload is a [`<ml>`](#ml) document, without any support for whitespace ou
No whitespace is allowed in FQY's payload and the payload size reflects this,
and is set to the correct value.*
## User on another service
## User on the same service
```
C: FQY 1 53
<ml>
@ -57,7 +57,7 @@ S: FQY 1 59
</ml>
```
## User on the same service
## User on another service
```
C: FQY 2 53
<ml>

4
docs/commands/gcf.md
View file

@ -6,7 +6,8 @@ It is a Notification Server command, without a request payload and WITH a respon
It gets configuration data from a file on the server.
# Client/Request
*Only in [MSNP11](../versions/msnp11.md) and [MSNP12](./versions/msnp12.md).*
*Only in [MSNP11](../versions/msnp11.md) and [MSNP12](../versions/msnp12.md).*
`GCF TrID filename`
Where filename is the file to retrieve. Only `Shields.xml` is known to be this parameter.
@ -58,7 +59,6 @@ S: USR 2 TWN S passport=parameters,neat=huh,lc=1033,id=507
```
C: GCF 3 Shields.xml
```
Server disconnects client.
# Known changes

11
docs/commands/gtc.md
View file

@ -36,12 +36,17 @@ S: 218 4
```
## Invalid argument
*NOTE: This is an assumption. The actual error code here is unknown.
It may also lead to an Instant Disconnection.*
```
C: GTC 5 B
S: 201 5
```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: GTC 6 A
```
Server disconnects client.
# Known changes
* [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode.

3
docs/commands/iln.md
View file

@ -45,7 +45,7 @@ Optional. Added since [MSNP14](../versions/msnp14.md).
# Examples
## Wihout anything special
## Only with status
```
C: CHG 1 NLN
S: CHG 1 NLN
@ -112,7 +112,6 @@ S: ILN 5 NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20
```
C: ILN 6 FLN example@hotmail.com example%20user
```
Server disconnects client.
# Known changes

1
docs/commands/ims.md
View file

@ -33,7 +33,6 @@ S: IMS 2 0 OFF
```
C: IMS 3 TOMORROW
```
Server disconnects client.
# Known changes

2
docs/commands/inf.md
View file

@ -14,7 +14,7 @@ Any further uses of this command in the same session is Undefined Behaviour.
# Server/Response
`INF TrID security-package {security-package ...}`
Where (unlikely multiple) `security-package` parameters being the avaliable authentication methods your client is allowed to use.
Where one or more `security-package` parameters being the avaliable authentication methods your client is allowed to use.
# Examples

1
docs/commands/ipg.md
View file

@ -44,7 +44,6 @@ S: IPG 478
```
C: IPG 1 0
```
Server disconnects client.
# Known changes

1
docs/commands/iro.md
View file

@ -43,7 +43,6 @@ S: ANS 2 OK
```
C: IRO 3
```
Server disconnects client.
# Known changes

1
docs/commands/joi.md
View file

@ -35,7 +35,6 @@ S: JOI anotheruser@hotmail.com another%20user 1342554172
```
C: JOI 2
```
Server disconnects client.
# Known changes

19
docs/commands/lst.md
View file

@ -33,7 +33,7 @@ Added since [MSNP7](../versions/msnp7.md).
## In SYN
### First generation
### First generation parameters
*Applies for [MSNP2](../versions/msnp2.md) to [MSNP6](../versions/msnp6.md).*
Same as the response [Outside of SYN](#outside-of-syn).
@ -46,7 +46,7 @@ Same as the response [Outside of SYN](#outside-of-syn).
Where `groups` is a comma-delimited list of Group IDs this contact is in,
only appended if the list (parameter 1) is set to FL. Defaults to `0`.
### Second generation
### Second generation parameters
*Applies for [MSNP8](../versions/msnp8.md) and [MSNP9](../versions/msnp9.md)*
`LST user-handle stored-friendly-name list-bits {groups}`
@ -60,14 +60,14 @@ Where `list-bits` are in the format:
Where `groups` is a comma-delimited list of Group IDs this contact is in,
only appended if Forward List (FL) is set in `list-bits`. Defaults to `0`.
### Third generation
### Third generation parameters
*Applies for [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 0`.*
`LST N=user-handle F=stored-friendly-name list-bits {groups}`
Same parameters as the [second generation](#second-generation).
### Fourth generation
### Fourth generation parameters
*Applies for [MSNP10](../versions/msnp10.md) and [MSNP11](../versions/msnp11.md) with `ABCHMigrated: 1`.*
`LST N=user-handle F=stored-friendly-name C=contact-guid list-bits {groupGuids}`
@ -77,7 +77,7 @@ Where `contact-guid` is the GUID/UUID of the contact.
Where `groupGuids` is a comma-delimited list of Group GUIDs this contact is in,
only appending if Forward List (FL) is set in `list-bits`, defaults to whatever "Other Contacts"'s GUID is.
### Fifth generation
### Fifth generation parameters
*Applies for [MSNP12](../versions/msnp12.md).*
`LST N=user-handle F=stored-friendly-name C=contact-guid list-bits network-id {groupGuids}`
@ -131,7 +131,7 @@ S: LST 4 BL 5 0 0
S: LST 4 RL 5 1 1 anotheruser@hotmail.com another%20user
```
### Using second generation
### Using second generation parameters
*Only in [MSNP8](../versions/msnp8.md) and [MSNP9](../versions/msnp9.md).*
```
C: SYN 5 0
@ -143,7 +143,7 @@ S: LSG 0 Other%20Contacts 0
S: LST anotheruser@hotmail.com another%20user 11 0
```
### Using third generation
### Using third generation parameters
*Only in [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 0`.*
```
@ -156,7 +156,7 @@ S: LSG Other%20Contacts 0
S: LST N=anotheruser@hotmail.com F=another%20user C=anotheruser@hotmail.com 11 0
```
### Using fourth generation
### Using fourth generation parameters
*Only in [MSNP10](../versions/msnp10.md) and [MSNP11](../versions/msnp11.md) with `ABCHMigrated: 1`.*
```
C: SYN 7 0 0
@ -168,8 +168,7 @@ S: LSG Other%20Contacts d6deeacd-7849-4de4-93c5-d130915d0042
S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056a4c55b98 11 d6deeacd-7849-4de4-93c5-d130915d0042
```
### Using fifth generation
### Using fifth generation parameters
*Only in [MSNP12](../versions/msnp12.md).*
```
C: SYN 8 0 0

9
docs/commands/msg.md
View file

@ -47,7 +47,7 @@ usually containing a `MIME-Version` header and a `Content-Type`.
### Unacknowledged message
```
C: MSG 1 U 75
C: MSG 1 U 76
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
@ -56,7 +56,7 @@ unacknowledged
### Acknowledged message
```
C: MSG A 2 73
C: MSG A 2 74
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
@ -66,7 +66,7 @@ S: ACK 2
### Negative-Acknowledged message
```
C: MSG 3 2 85
C: MSG 3 2 86
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
@ -88,7 +88,7 @@ S: ACK 4
### Poorly formatted data message
*Since [MSNP9](../versions/msnp9.md).*
```
C: MSG 5 D 74
C: MSG 5 D 75
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
@ -101,7 +101,6 @@ S: 282 5
```
C: MSG 6 U 0
```
Server disconnects client.
## Server initated

3
docs/commands/nak.md
View file

@ -15,7 +15,7 @@ This command can not be sent from the client.
## As a response to MSG N
```
C: MSG 1 N 68
C: MSG 1 N 69
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
@ -28,7 +28,6 @@ S: NAK 1
```
C: NAK 2
```
Server disconnects client.
# Known changes

3
docs/commands/nln.md
View file

@ -42,7 +42,7 @@ Optional. Added since [MSNP14](../versions/msnp14.md).
# Examples
## Wihout anything special
## Only with status
```
S: NLN NLN anotheruser@example.com another%20user
```
@ -99,7 +99,6 @@ S: NLN NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20Cr
```
C: NLN FLN example@hotmail.com example%20user
```
Server disconnects client.
# Known changes

1
docs/commands/not.md
View file

@ -124,7 +124,6 @@ S: NOT 694
```
C: NOT 1 0
```
Server disconnects client.
# Known changes

5
docs/commands/out.md
View file

@ -31,7 +31,6 @@ Where `minutes` is the amount of minutes the client should wait before trying to
C: OUT
S: OUT
```
Server disconnects client.
## Logged in from another client
@ -44,7 +43,7 @@ S: OUT OTH
S: OUT SSD
```
## ABCH Migration
## ABCH migration
*Only in [MSNP10](../versions/msnp10.md).*
```
S: OUT MIG
@ -56,7 +55,7 @@ S: OUT MIG
S: OUT TOU
```
## Forced Reconnect
## Forced reconnect
*Since [MSNP11](../versions/msnp11.md).*
```
S: OUT RCT 6

4
docs/commands/pag.md
View file

@ -1,7 +1,7 @@
# Introduction
`PAG` is a command introduced with [MSNP5](../versions/msnp5.md).
It is a Notification Server command, with a request payload.
It is a Notification Server command, WITH a request payload.
It sends a text message to a mobile device or pager.
For the version of this command that supports Web Watches, read [PGD](pgd.md).
@ -64,7 +64,7 @@ C: PAG 5 anotheruser@hotmail.com 61
S: 800 5
```
## Removed
## Command removed
*Since [MSNP9](../versions/msnp9.md).*
```
C: PAG 6 anotheruser@hotmail.com 61

3
docs/commands/pgd.md
View file

@ -1,7 +1,7 @@
# Introduction
`PGD` is a command introduced with [MSNP9](../versions/msnp9.md).
It is a Notification Server command, with a request payload.
It is a Notification Server command, WITH a request payload.
It sends a text message to a mobile device/pager or Web Watch.
For the version of this command that doesn't support Web watches, read [PAG](pag.md).
@ -102,7 +102,6 @@ S: 201 8
C: PGD 9 anotheruser@hotmail.com W 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
```
Server disconnects client.
# Known changes

4
docs/commands/png.md
View file

@ -1,7 +1,7 @@
# Introduction
`PNG` is a command introduced with [MSNP2](../versions/msnp2.md).
It is a Notification Server command, without either a request or response payload.
It is a Notification Server command, without a request payload.
Makes the server respond with a [QNG](qng.md) command.
@ -13,7 +13,7 @@ The server responds to this command via [QNG](qng.md).
# Examples
## Client-sent
## Client-initiated
```
C: PNG
S: QNG

2
docs/commands/prp.md
View file

@ -47,7 +47,6 @@ S: 715 2
```
C: PRP 3 NICE Y
```
Server disconnects client.
## Property value is too long
@ -57,7 +56,6 @@ Lines beginning with `..` followed by a space are continuations of the previous
C: PRP 4 PHM this%20is%20way%20too%20long%20of%20a
.. %20phone%20number%20not%20like%20it%20is%20one%20anyway...
```
Server disconnects client.
# Known changes

6
docs/commands/qng.md
View file

@ -15,13 +15,14 @@ Where `next-seconds` is the amount of seconds until the client should send anoth
# Examples
## Server-reply, old
## Server reply, without next seconds parameter
*Only in [MSNP2](../versions/msnp2.md) to [MSNP8](../versions/msnp8.md).*
```
C: PNG
S: QNG
```
## Server-reply, new
## Server reply, with next seconds parameter
*Since [MSNP9](../versions/msnp9.md).*
```
C: PNG
@ -33,7 +34,6 @@ S: QNG 50
```
C: QNG
```
Server disconnects client.
# Known changes

1
docs/commands/qry.md
View file

@ -62,7 +62,6 @@ C: QRY 2 msmsgs@msnmsgr.com 32
8ba1bb9d6dbf624fee31a2053af5fdd0
S: 540 2
```
Server disconnects client.
# Known changes

13
docs/commands/rea.md
View file

@ -3,7 +3,8 @@
It is a Notification Server command, without either a request or response payload.
Renames a user. For the commands that replaced REA with a `MFN` property, read [PRP](prp.md) and [SBP](sbp.md).
Renames a user.
For the commands that replaced REA with a `MFN` property, read [PRP](prp.md) and [SBP](sbp.md).
# Client/Request
`REA TrID user-handle new-friendly-name`
@ -12,8 +13,8 @@ Where `user-handle` is the user handle that you'd like to change the friendly na
If this is the current user's handle, the change will be announced via
[NLN](nln.md) to all users on your Reverse List (RL) if they are not in your Block List (BL).
Where `new-friendly-name` is the friendly name you'd like to set.
Subject to server-side restrictions.
Where `new-friendly-name` is the friendly name you'd like to set,
which may be rejected for any reason by the server.
# Server/Response
`REA TrID list-version user-handle new-friendly-name`
@ -35,19 +36,19 @@ C: REA 2 anotheruser@hotmail.com different%20name
S: REA 2 257 anotheruser@hotmail.com different%20name
```
## Not allowed to be called that
## You are not allowed to have that name
```
C: REA 3 example@hotmail.com bad
S: 209 3
```
## Can not change the friendly name of a user not in your lists
## You can not change the friendly name of a user that is not on any of your Lists
```
C: REA 4 ghost@hotmail.com ghost
S: 216 4
```
## Rate limited, try again later
## You have been rate limited, try again later
```
C: REA 5 example@hotmail.com new%20name%201
S: REA 5 258 example@hotmail.com new%20name%201

13
docs/commands/reg.md
View file

@ -45,8 +45,7 @@ S: 224 2
```
C: REG 3 30 example%20out%20of%20bounds%20group 0
```
Server disconnects client
Server disconnects client.
### Group name extremely long
*NOTE: This has been line-breaked.
@ -56,7 +55,6 @@ C: REG 4 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAA 0
```
Server disconnects client.
## Without list versions
@ -80,7 +78,6 @@ S: 224 6
```
C: REG 7 30 still%20out%20of%20bounds
```
Server disconnects client.
### Group name extremely long
@ -91,7 +88,6 @@ C: REG 8 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAA
```
Server disconnects client.
### With group GUIDs
@ -113,7 +109,6 @@ S: 224 10
```
C: REG 11 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! very%20invalid%20GUID%20there
```
Server disconnects client.
### Group name extremely long
@ -124,7 +119,13 @@ C: REG 12 d6deeacd-7849-4de4-93c5-d130915d0042 AAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: REG 13 f60efbe7-94af-4b16-b926-e4e10878d329 Other%20Friends
```
Server disconnects client.
# Known changes

6
docs/commands/rem.md
View file

@ -111,7 +111,13 @@ S: 225 11
```
C: REM 12 RL anotheruser@hotmail.com
```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: REM 13 FL anotheruser@hotmail.com
```
Server disconnects client.
## Asynchronous update

10
docs/commands/rmg.md
View file

@ -51,7 +51,6 @@ S: 230 3
```
C: RMG 4 30
```
Server disconnects client.
### With group IDs
@ -79,7 +78,6 @@ S: 230 7
```
C: RMG 8 30
```
Server disconnects client.
### With group GUIDs
@ -105,9 +103,15 @@ S: 230 11
#### Can not remove out-of-bounds groups
```
C: RMG 8 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL!
C: RMG 12 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL!
```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: RMG 13 f60efbe7-94af-4b16-b926-e4e10878d329
```
Server disconnects client.
# Known changes

1
docs/commands/rng.md
View file

@ -65,7 +65,6 @@ S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789
```
C: RNG 1
```
Server disconnects client.
# Known changes

31
docs/commands/sbp.md
View file

@ -7,7 +7,7 @@ Sets a buddy's property in your cache to a specified value.
For the command this replaced, read [REA](rea.md).
# Client/Request
`SBP TrID contact-id property value`
`SBP TrID contact-id property value {unknown}`
Where `contact-id` is the `C=` value from either [ADD](add.md) or [LST](lst.md).
If you are using `ABCHMigrated: 0`, this is the contact's user handle.
@ -17,10 +17,14 @@ Where `property` are any of the values:
* `MFN`: My Friendly Name
* `MOB`: User can contact me via MSN Mobile, changed by the Client Capability.
* `WWE`: User can contact me via MSN Direct, changed by the Client Capability.
* `PHM`: [MSNP11](../versions/msnp11.md)+: The user's mobile phone number.
* `HSB`: [MSNP11](../versions/msnp11.md)+: Has blog, changed by the Client Capability.
Where `value` is the URL-encoded value to set the related `property` to.
Where `unknown` is set to `1` if setting the `property` of `PHM`. Added since [MSNP11](../versions/msnp11.md)
(TODO: What does this mean?)
# Server/Response
`SBP TrID contact-id property value`
@ -28,25 +32,42 @@ Same parameters as the request.
# Examples
## Normal use
### Without GUIDs
## Without GUIDs
*Only with `ABCHMigrated: 0`.*
### My friendly name
```
C: SBP 1 anotheruser@hotmail.com MFN another%20user
S: SBP 1 anotheruser@hotmail.com MFN anoter%20user
```
### With GUIDs
## With GUIDs
*Only with `ABCHMigrated: 1`.*
### My friendly name
```
C: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
S: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
```
### Contact mobile number
*Since [MSNP11](../versions/msnp11.md).*
*TODO: Is this correct? Needs mobile stuff enabled in msgrconfig.*
```
C: SBP 3 c1f9a363-4ee9-4a33-a434-b056a4c55b95 PHM tel:+15554444333 1
S: SBP 3 c1f9a363-4ee9-4a33-a434-b056a4c55b95 PHM tel:+15554444333 1
```
## Errors
None are currently known. If you know of one, please contact me.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: SBP 4 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
```
Server disconnects client.
# Known changes
* [MSNP11](../versions/msnp11.md): Added support for `HSB` property.
* [MSNP13](../versions/msnp13.md): Removed, use [Address Book Service](../services/abservice.md)'s `ABContactUpdate` action instead.

7
docs/commands/sdc.md
View file

@ -1,7 +1,7 @@
# Introduction
`SDC` is a command introduced with [MSNP5](../versions/msnp5.md).
It is a Notification Server command, with a request payload, but without a response payload.
It is a Notification Server command, WITH a request payload and without a response payload.
Sends a service invitation to an e-mail address or directory user.
For the version of this command that does not support friendly names, read [SND](snd.md).
@ -10,13 +10,13 @@ For the version of this command that does not support friendly names, read [SND]
```
SDC TrID target-address translation-lcid requesting-library client-identification X X my-friendly-name length
payload
````
```
Where `target-address` is the E-mail address or index from the last [FND](fnd.md) response you'd like to invite to the service.
Where `translation-lcid` is the LCID of the translation you'd like the invitation to be in.
Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`.
Where `requesting-library` is the name of the library that sent this SDC, usually `MSMSGS` or `MSNMSGR`.
Where `client-identification` is the internal name of the codebase used to create `requesting-library`, usually `MSMSGS`.
@ -76,7 +76,6 @@ S: SDC 6 OK
C: SDC 7 anotheruser@hotmail.com 10
S: 503 7
```
Server disconnects client.
# Known changes

11
docs/commands/snd.md
View file

@ -14,7 +14,7 @@ Where `target-address` is the E-mail address or index from the last [FND](fnd.md
Where `translation-lcid` is the LCID of the translation you'd like the invitation to be in.
Added since [MSNP3](../versions/msnp3.md).
Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`.
Where `requesting-library` is the name of the library that sent this SND, usually `MSMSGS` or `MSNMSGR`.
Added since [MSNP3](../versions/msnp3.md).
Where `client-identification` is the internal name of the codebase used to create `requesting-library`, usually `MSMSGS`.
@ -29,20 +29,20 @@ Where `OK` is always `OK`.
## Normal use
### First generation
### E-mail only
*Only in [MSNP2](../versions/msnp2.md).*
```
C: SND 1 anotheruser@hotmail.com
S: SND 1 OK
```
### Second generation
### With language ID and client library name
*Only in [MSNP3](../versions/msnp3.md).*
```
C: SND 2 anotheruser@hotmail.com 0x0409 MSMSGS
S: SND 2 OK
```
### Third generation
### With the client internal name
*Since [MSNP4](../versions/msnp4.md).*
```
C: SND 3 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS
@ -63,10 +63,9 @@ S: SND 5 OK
C: SND 6 anotheruser@hotmail.com 10
S: 503 6
```
Server disconnects client.
# Known changes
* [MSNP3](../versions/msnp3.md): Added translation support and requesting library parameters.
* [MSNP4](../versions/msnp4.md): Added client codebase parameter.
* [MSNP5](../versions/msnp5.md): Deprecated in place of [SDC](sdc.md).
* [MSNP5](../versions/msnp5.md): Deprecated. Use [SDC](sdc.md) instead.

3
docs/commands/syn.md
View file

@ -249,12 +249,11 @@ S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056
S: BPR PHH 1%20(222)%20333%204444
```
## Removed
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: SYN 16 0 0
```
Server disconnects client.
# Known changes

1
docs/commands/ubx.md
View file

@ -132,7 +132,6 @@ S: UUX anotheruser@hotmail.com 1 202
```
C: UBX 1 0
```
Server disconnects client.
# Known changes

2
docs/commands/url.md
View file

@ -74,7 +74,7 @@ C: URL 4 MOBILE
S: URL 4 http://mobile.msn.com/hotmail/confirmUser.asp?URL=%2Fmessengerok.htm&mobID=1 https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 961
```
## Edit Member Directory Profile
## Edit Member Directory profile
*Since [MSNP6](../versions/msnp3.md).*
```
C: URL 5 PROFILE 0x0409

26
docs/commands/usr.md
View file

@ -20,7 +20,8 @@ Depending on the version of the protocol you are using, `security-package` can b
* `CTP`: Clear Text Password. Only in [MSNP2](../versions/msnp2.md).
* `MD5`: MD5-based authentication. Only in [MSNP2](../versions/msnp2.md) to [MSNP7](../versions/msnp7.md).
* `TWN`: "Tweener", [Passport 1.4](../services/passport14.md) or compatible authentication service. Since [MSNP8](../versions/msnp8.md).
* `SSO`: Single Sign On, usually a more advanced [Passport (SOAP)](../services/passportsoap.md) authentication method. Since [MSNP15](../versions/msnp15.md).
* `SSO`: Single Sign On, using a more advanced version of the
[Passport Request Security Token service](../services/rst.md) based authentication method. Since [MSNP15](../versions/msnp15.md).
### The Subsequent request
`USR TrID security-package S {...response-args}`
@ -29,9 +30,10 @@ Where `response-args` can be anything, but based on `security-package` it can be
* `CTP`: Your password in plain text.
* `MD5`: The server's login challenge concatenated with your password.
* `TWN`: The `from-PP` parameter in the `Authentication-Info` header sent in response to [Passport 1.4](../services/passport14.md),
or if using [Passport (SOAP)](../services/passportsoap.md), the `<wsse:BinarySecurityToken>` of the relevant `<wst:RequestSecurityTokenResponse>`.
* `SSO`: The same as [Passport (SOAP)](../services/passportsoap.md) in `TWN`, but with the extra parameter
being the custom challenge response encoded as base64.
or if using the [Passport Request Security Token service](../services/rst.md),
the `<wsse:BinarySecurityToken>` of the relevant `<wst:RequestSecurityTokenResponse>`.
* `SSO`: The same as the [Passport Request Security Token service](../services/rst.md)
in `TWN`, but with the extra parameter being the custom challenge response encoded as base64.
## Switchboard Server
`USR TrID user-handle cookie`
@ -120,15 +122,16 @@ C: USR 7 SSO I example@hotmail.com
S: USR 7 SSO S MBI_KEY_OLD AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=
```
*The HTTPS interlude has been moved to the [Passport (SOAP)](../services/passportsoap.md) article.*
*The HTTPS interlude has been moved to the
[Passport Request Security Token service](../services/rst.md) article.*
*The key-encryption interlude has been removed from here and is to reinstated as another article.*
```
C: USR 8 SSO S t=ticket HAAAAAEAAAADZgAABIAAAAgAAAAUAAAASAAAAAA
.. AAAAAAAAA7XgT5ohvaZdoXdrWUUcMF2G8OK2JohyYcK5l5MJSitab33scxJe
.. K/RQXcUr0L+R2ZA9CEAzn0izmUzSMp2LZdxSbHtnuxCmptgtoScHp9E26HjQ
.. VkA9YJxgK/HM=
C: USR 8 SSO S t=ticket&p=HAAAAAEAAAADZgAABIAAAAgAAAAUAAAASAAAA
.. AAAAAAAAAAA7XgT5ohvaZdoXdrWUUcMF2G8OK2JohyYcK5l5MJSitab33scx
.. JeK/RQXcUr0L+R2ZA9CEAzn0izmUzSMp2LZdxSbHtnuxCmptgtoScHp9E26H
.. jQVkA9YJxgK/HM=
S: USR 8 OK example@hotmail.com
```
@ -139,7 +142,6 @@ S: USR 9 TWN S passport=parameters,neat=huh,lc=1033,id=507
C: USR 10 TWN S t=not*a*passport*ticket&p=not*a*profile*either
S: 911 10
```
Server disconnects client.
### Child account not authorized
@ -150,7 +152,6 @@ S: USR 11 MD5 S 1234567890.123456789
C: USR 12 MD5 S f59af8f2fa91d38aff7c870c17f99903
S: 923 12
```
Server disconnects client.
### Account not verified
@ -165,7 +166,6 @@ S: USR 13 MD5 S 1234567890.123456789
C: USR 14 MD5 S f59af8f2fa91d38aff7c870c17f99903
S: 924 14
```
Server disconnects client.
#### Soft warning
@ -187,7 +187,6 @@ S: USR 17 TWN S passport=parameters,neat=huh,lc=1033,id=507
C: USR 18 TWN S t=token&p=profile
S: USR 18 OK example@hotmail.com example%20user 1 1
```
Client disconnects from server.
### Wrong server for this account
@ -195,7 +194,6 @@ Client disconnects from server.
C: USR 19 TWN I example@hotmail.com
S: 931 19
```
Server disconnects client.
## Switchboard Server

1
docs/commands/uux.md
View file

@ -103,7 +103,6 @@ S: UUX 6
C: UUX 7 19
<invalid></invalid>
```
Server disconnects client.
# Known changes

6
docs/commands/ver.md
View file

@ -22,20 +22,20 @@ If the server's `preferred-dialect-name` is `0`, that means it doesn't want to u
# Examples
## Unsupported Protocols
## No supported protocols
```
C: VER 1 DISREGARDANCE FOR A REAL PROTOCOL
S: VER 1 0
```
Server disconnects client.
## Supported Fallback Protocol
## Supported fallback protocol
```
C: VER 2 MSNP2 CVR0
S: VER 2 CVR0
```
## Supported Primary Protocol
## Supported primary protocol
```
C: VER 3 MSNP8 CVR0
S: VER 3 MSNP8

16
docs/commands/xfr.md
View file

@ -66,9 +66,9 @@ S: XFR 1 SB 10.0.1.200:1865 CKI 123456789.123456789.123456789
C: XFR 2 NS
S: XFR 2 NS 10.0.0.5:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
### Client referred from Dispatch Server
@ -78,9 +78,9 @@ Client opens a connection to 10.0.0.5:1863
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
#### Classic
*Only in [MSNP3](../versions/msnp3.md) to [MSNP6](../versions/msnp6.md).*
@ -88,9 +88,9 @@ Client opens a connection to 10.0.0.5:1863
C: USR 4 MD5 I example@hotmail.com
S: XFR 4 NS 10.0.0.5:1863 0
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
#### Modern
*Only in [MSNP7](../versions/msnp7.md) to [MSNP12](../versions/msnp12.md).*
@ -98,9 +98,9 @@ Client opens a connection to 10.0.0.5:1863
C: USR 5 MD5 I example@hotmail.com
S: XFR 5 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
## After rework
*Since [MSNP13](../versions/msnp13.md).*

114
docs/errors_and_hresults.md Normal file
View file

@ -0,0 +1,114 @@
# Error codes and HRESULTs
The following is a list of all **known** MSNP error codes and related `HRESULT` values.
If you know any error that isn't listed, please contact me.
For valid MSNP commands, read the [Table of Commands](table_of_commands.md).
## MSNP error codes
| `MSNP ERROR CODE` | related `HRESULT` value | related `HRESULT`'s name | `DRAFT` name | Description / Known reason? |
| ----- | ------------ | -------------------------------------- | ------------------------------ | ------------------ |
| `200` | N/A | N/A | `ERR_SYNTAX_ERROR` | Syntax error. |
| `201` | `0x81000435` | `MSGR_E_MSNP_INVALID_PARAMETER` | `ERR_INVALID_PARAMETER` | Invalid parameter in command. |
| `203` | `0x810003c0` | `MSGR_E_INVALID_FEDERATED_USER` | N/A | ? |
| `204` | `0x8100037c` | `MSGR_E_UNROUTABLE_USER` | N/A | ? |
| `205` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_INVALID_USER` | The user is invalid. |
| `206` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_FQDN_MISSING` | The domain name of the user handle is missing. |
| `207` | `0x81000304` | `MSGR_E_ALREADY_LOGGED_ON` | `ERR_ALREADY_LOGIN` | You are already logged in. |
| `208` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_INVALID_USERNAME` | The username of the user handle is invalid. |
| `209` | `0x81000324` | `MSGR_E_INVALID_FRIENDLY_NAME` | `ERR_INVALID_FRIENDLY_NAME` | You cannot use that friendly name. |
| `210` | `0x81000307` | `MSGR_E_LIST_FULL` | `ERR_LIST_FULL` | That list is full. |
| `212` | `0x8100030d` | `MSGR_E_UNEXPECTED` | N/A | ? |
| `213` | `0x81000392` | `MSGR_E_USER_DOESNT_EXIST` | N/A | ? |
| `215` | `0x8100030b` | `MSGR_E_ALREADY_IN_LIST` | `ERR_ALREADY_THERE` | That user is already added to that list. |
| `216` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_NOT_ON_LIST` | This user is not on any of your lists. |
| `217` | `0x81000430` | `MSGR_E_MSNP_NOT_ACCEPTING_IMS` | N/A | That user is currently not accepting instant messages. |
| `218` | `0x01000301` | `MSGR_S_ALREADY_IN_THE_MODE` | `ERR_ALREADY_IN_THE_MODE` | You are already in the mode specified. |
| `219` | `0x81000431` | `MSGR_E_MSNP_ALREADY_IN_OPPOSITE_LIST` | `ERR_ALREADY_IN_OPPOSITE_LIST` | The user is in a mutually exclusive list and therefore can not be added to the specified one. |
| `220` | `0x81000335` | `MSGR_E_NOT_ACCEPTING_PAGES` | N/A | ? |
| `232` | `0x810003b5` | `MSGR_E_INVALID_MSISDN` | N/A | ? |
| `233` | `0x810003b6` | `MSGR_E_UNKNOWN_MSISDN` | N/A | ? |
| `234` | `0x81000439` | `MSGR_E_MSNP_UNKNOWN_KEITAI_DOMAIN` | N/A | ? |
| `240` | `0x8100043b` | `MSGR_E_MSNP_INVALID_XML` | N/A | ? |
| `241` | `0x8100043a` | `MSGR_E_MSNP_INVALID_XML_DATA` | N/A | ? |
| `280` | `0x81000436` | `MSGR_E_MSNP_SWITCHBOARD_FAILED` | `ERR_SWITCHBOARD_FAILED` | ? |
| `281` | N/A | N/A | `ERR_NOTIFY_XFR_FAILED` | ? |
| `300` | N/A | N/A | `ERR_REQUIRED_FIELDS_MISSING` | ? |
| `302` | N/A | N/A | `ERR_NOT_LOGGED_IN` | You need to log in to perform that action. |
| `400` | `0x81000376` | `MSGR_E_ABCH_READ_ONLY` | N/A | Your Address Book is read-only and can not be used. |
| `402` | `0x81000377` | `MSGR_E_ABCH_TOO_BUSY` | N/A | The Address Book service is currently too busy. |
| `403` | `0x81000378` | `MSGR_E_ABCH_UNAVAILABLE` | N/A | The Address Book service is currently unavaliable. |
| `413` | `0x810003a5` | `MSGR_E_SUBSCRIPTION_NEEDED` | N/A | ? |
| `414` | `0x810003a6` | `MSGR_E_SUBSCRIPTION_DISABLED` | N/A | ? |
| `416` | `0x810003c1` | `MSGR_E_MARKET_DISABLED` | N/A | ? |
| `417` | `0x810003c2` | `MSGR_E_DISABLED_EVERYWHERE` | N/A | ? |
| `418` | `0x810003c3` | `MSGR_E_TRY_AGAIN_LATER` | N/A | ? |
| `419` | `0x810003c4` | `MSGR_E_NO_MARKET_SPECIFIED` | N/A | ? |
| `420` | `0x810003cc` | `MSGR_E_INVITE_REQUIRED` | N/A | You need an invitation to use this version of the Official Client. |
| `500` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | `ERR_INTERNAL_SERVER` | Internal server error. |
| `501` | N/A | N/A | `ERR_DB_SERVER` | ? |
| `503` | `0x80004005` | `MSGR_E_FAIL` / `E_FAIL` | N/A | Unspecified failure. |
| `504` | `0x810003c5` | `MSGR_E_UPS_UNAVAILABLE` | N/A | ? |
| `505` | `0x810003c6` | `MSGR_E_SCS_UNAVAILABLE` | N/A | ? |
| `508` | `0x81000433` | `MSGR_E_MSNP_FEDERATED_SERVER_ERROR` | N/A | ? |
| `509` | `0x81000434` | `MSGR_E_MSNP_UUM_ERROR` | N/A | ? |
| `510` | N/A | N/A | `ERR_FILE_OPERATION` | ? |
| `511` | `0x81000603` | `MSGR_E_PPLATFORM_SERVER_511` | N/A | ? |
| `520` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | `ERR_MEMORY_ALLOC` | ? |
| `540` | `0x8100036d` | `MSGR_E_LOCKANDKEY_FAILED` | N/A | ? |
| `600` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | `ERR_SERVER_BUSY` | ? |
| `601` | `0x81000314` | `MSGR_E_SERVER_UNAVAILABLE` | `ERR_SERVER_UNAVAILABLE` | The server is unavaliable at this time. |
| `602` | N/A | N/A | `ERR_PEER_NS_DOWN` | ? |
| `603` | N/A | N/A | `ERR_DB_CONNECT` | ? |
| `604` | N/A | N/A | `ERR_SERVER_GOING_DOWN` | ? |
| `606` | `0x81000339` | `MSGR_E_PAGING_UNAVAILABLE` | N/A | ? |
| `707` | N/A | N/A | `ERR_CREATE_CONNECTION` | ? |
| `710` | `0x81000339` | `MSGR_E_PAGING_UNAVAILABLE` | N/A | ? |
| `711` | N/A | N/A | `ERR_BLOCKING_WRITE` | ? |
| `712` | N/A | N/A | `ERR_SESSION_OVERLOAD` | ? |
| `713` | N/A | N/A | `ERR_USER_TOO_ACTIVE` | You are being too active. You have been rate limited. |
| `714` | N/A | N/A | `ERR_TOO_MANY_SESSIONS` | ? |
| `715` | `0x81000438` | `MSGR_E_MSNP_NOT_EXPECTED` | `ERR_NOT_EXPECTED` | Command not expected at that time. |
| `717` | N/A | N/A | `ERR_BAD_FRIEND_FILE` | ? |
| `718` | `0x8100035a` | `MSGR_E_RESTRICTED_USER` | N/A | ? |
| `719` | `0x810003c7` | `MSGR_E_FEDERATED_SESSION` | N/A | ? |
| `726` | `0x8100037d` | `MSGR_E_USER_FEDERATED` | N/A | ? |
| `729` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | ? |
| `800` | `0x81000398` | `MSGR_E_RATE_LIMIT_EXCEEDED` | N/A | You are being rate limited. |
| `910` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | The server is too busy to authenticate your user. |
| `911` | `0x81000395` | `MSGR_E_MSNP_911` | `ERR_AUTHENTICATION_FAILED` | Generic authentication failure. |
| `913` | `0x8100043c` | `MSGR_E_MSNP_NOT_ALLOWED_WHEN_OFFLINE` | `ERR_NOT_ALLOWED_WHEN_OFFLINE` | You may not do that while appearing offline or in semi-offline mode. |
| `917` | `0x81000327` | `MSGR_E_INVALID_DOMAIN` | N/A | The domain specified at authentication is invalid. |
| `918` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | N/A | ? |
| `919` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | N/A | ? |
| `920` | `0x81000326` | N/A | `ERR_NOT_ACCEPTING_NEW_USERS` | The server is too full and is no longer accepting new authentication requests. |
| `921` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | The server is too busy to authenticate your user. |
| `922` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | ? |
| `923` | `0x81000331` | `MSGR_E_CHILD_WITHOUT_CONSENT` | N/A | Child account does not have authorization to use the Messenger Service. |
| `924` | `0x81000336` | `MSGR_E_EMAIL_PASSPORT_NOT_VALIDATED` | N/A | You need to verify your account before using the Messenger Service. |
| `926` | `0x81000359` | `MSGR_E_MANAGED_USER_INVALID_CVR` | N/A | The account's permissions could not be verified. |
| `927` | `0x8100035a` | `MSGR_E_RESTRICTED_USER` | N/A | The parent or guardian of this account has blocked access of the Messenger Service using this account. |
| `928` | `0x81000303` | `MSGR_E_INVALID_PASSWORD` | N/A | The password provided is invalid. |
| `929` | `0x81000385` | `MSGR_E_LOCKANDKEY_FAILED_FOR_MCAA` | N/A | ? |
| `930` | `0x8100037b` | `MSGR_E_FEDERATED_DOMAIN` | N/A | This account belongs to a enterprise domain and can not be used on the Messenger Service. |
| `934` | `0x81000410` | `MSGR_E_FSS_USER_NO_ACCESS` | N/A | ? |
## Common HRESULTS without related MSNP error codes
| related `HRESULT` value | related `HRESULT`'s name | Description / Known reason? |
| ------------ | ------------------------------------------------- | ------------- |
| `0x80004005` | `E_FAIL` | Unspecified failure. |
| `0x00048802` | `PPCRL_AUTHSTATE_S_AUTHENTICATED_OFFLINE` | You are logged in, but working offline. |
| `0x00048803` | `PPCRL_AUTHSTATE_S_AUTHENTICATED_PASSWORD` | You are logged in using a password. |
| `0x80048810` | `PPCRL_AUTHREQUIRED_E_PASSWORD` | Please input your password. |
| `0x80048800` | `PPCRL_AUTHSTATE_E_UNAUTHENTICATED` | You are not logged in. |
| `0x80048801` | `PPCRL_AUTHSTATE_E_EXPIRED` | Your session has expired. Please log in again. |
| `0x80048820` | `PPCRL_REQUEST_E_AUTH_SERVER_ERROR` | Authentication server error. |
| `0x80048821` | `PPCRL_REQUEST_E_BAD_MEMBER_NAME_OR_PASSWORD` | Invalid email address or password. |
| `0x80048823` | `PPCRL_REQUEST_E_PASSWORD_LOCKED_OUT` | This account's password is disabled and needs to be reset. |
| `0x80048825` | `PPCRL_REQUEST_E_TOU_CONSENT_REQUIRED` | You must accept the service's Terms of Use before using this account.|
| `0x80048826` | `PPCRL_REQUEST_E_FORCE_RENAME_REQUIRED` | Your account details needs to be revised. |
| `0x80048827` | `PPCRL_REQUEST_E_FORCE_CHANGE_PASSWORD_REQUIRED` | Your account's password needs to be changed. |
| `0x80048831` | `PPCRL_REQUEST_E_PASSWORD_EXPIRED` | Your account's password has expired and needs to be changed. |
| `0x80048836` | `PPCRL_REQUEST_E_EMAIL_VALIDATION_REQUIRED` | Your account's e-mail address must be verified. |
| `0x80070002` | System Error `ERROR_FILE_NOT_FOUND` | A file could not be found. |
| `0x80070057` | System Error `ERROR_INVALID_PARAMETER` | One or more parameters have invalid values.
| `0x80072f7d` | System Error `ERROR_WINHTTP_SECURE_CHANNEL_ERROR` | Any possible secure channel (SSL) error from WinHTTP. |

4
docs/files/challenge_keypairs.md
View file

@ -41,7 +41,7 @@ Random characters in both cases will match the regular expression of
| `PROD01065C%ZFN6F` | `O4BG@C7BWLYQX?5G` | Client Version 8.0.0328 (unconfirmed) |
| `PROD0112J1LW7%NB` | `RH96F{PHI8PPX_TJ` | Client Version 8.0.0812 (unconfirmed) |
| `PROD0113H11T8$X_` | `RG@XY*28Q5QHS%Q5` | Client Version 8.1.0168 (unconfirmed) |
| `PROD0114ES4Z%Q5W` | `PK}_A_0N_K%O?A9S` | Client Version 8.1.0178 (unconfirmed) |
| `PROD0114ES4Z%Q5W` | `PK}_A_0N_K%O?A9S` | Client Version 8.1.0178 (unconfirmed), Client Version 9.0.1407 (confirmed) |
| `PROD0118R6%2WYOS` | `YIXPX@5I2P0UT*LK` | Client Version 8.5.1235 (unconfirmed) |
| `PROD0119GSJUC$18` | `ILTXC!4IXB5FB*PX` | Client Version 8.5.1288 (unconfirmed) |
| `PROD0120PW!CCV9@` | `C1BX{V4W}Q3*10SM` | Client Version 14.0.8050 (unconfirmed)|
| `PROD0120PW!CCV9@` | `C1BX{V4W}Q3*10SM` | Client Version 14.0.8050 (confirmed) |

6
docs/files/shields.md
View file

@ -37,9 +37,9 @@ This empty attribute has 5 parameters:
* `audio`: Audio Conversations.
* `filexfer`: File transfer.
* `hotlinks`: Web links.
If this feature is blocked URLs sent in the chat will not be formatted as links.
* `ddp`: Dynamic Display Pictures (Flash avatars).
* `winks`: Winks (Flash full chat window animations).
If this feature is blocked URLs sent in conversation windows will not be formatted as links.
* `ddp`: Dynamic Display Pictures (Flash-based profile pictures).
* `winks`: Winks (Flash-based full conversation window animations).
### block
*Since [MSNP12](../versions/msnp12.md).*

10
docs/index.md
View file

@ -26,6 +26,7 @@ A copy of the license is included in the article entitled
* [MSNP11](versions/msnp11.md)
* [MSNP12](versions/msnp12.md)
* [MSNP13](versions/msnp13.md)
* [MSNP14](versions/msnp14.md)
More is to come soon! Hopefully!
@ -34,12 +35,13 @@ More is to come soon! Hopefully!
* [Contact Sharing Service](services/sharingservice.md)
* [Messenger Config Service](services/msgrconfig.md)
* [Passport 1.4](services/passport14.md)
* [Passport (SOAP)](services/passportsoap.md)
* [Passport Request Security Token service](services/rst.md)
More is to come soon! Hopefully!
# Other documents and files
* [Constants used on the wiki](reference_constants.md)
* [List of Error Codes and HRESULTs](errors_and_hresults.md)
* [Shields Configuration Data](files/shields.md)
* [`<NOTIFICATION>` documents](files/notification.md)
* [Challenge key pairs](files/challenge_keypairs.md)
@ -54,7 +56,6 @@ More is to come soon! Hopefully!
* [MSNP11](versions/msnp11.md): How does `ABCHMigrated: 0` really work now? `OUT MIG` still exists.
* [MSNP12](versions/msnp12.md): Did [LST](commands/lst.md) change outside of [SYN](commands/syn.md) in this version?
* [MSNP18](versions/msnp18.md): Did `<NotificationData>`-based circle updates get added in [MSNP17](versions/msnp17.md) instead of [MSNP18](versions/msnp18.md)?
* Error Codes: A new article for them, seems like they are implemented in wildly different ways.
* [MSNP2](versions/msnp2.md) to [MSNP7](versions/msnp7.md): TODO: Add CVR requests as command 10.
* All Protocols: Any error code known to exist but is missing from the pages.
* All Protocols: Good [CVR](commands/cvr.md) responses, all of them are their release versions, when they could be latest.
@ -104,7 +105,8 @@ More is to come soon! Hopefully!
* `svcs.microsoft.com`: Usually a grab-bag of random XML files or services used for clients older than Client Version 6.0.
* Protocol Split: A MSNP version that usually defines a point of no return.
* PP14: [Passport SSI Version 1.4](services/passport14.md).
* PPSOAP: [Passport (SOAP)](services/passportsoap.md) that was implemented in Client Version 7.5+ ([MSNP12](versions/msnp12.md)).
* RST: The [Passport Request Security Token service](services/rst.md) that was implemented in Client Version 7.5+ ([MSNP12](versions/msnp12.md)).
* RST2: The second version of the Passport Request Security Token service that was implemented in Client Version 14.0+ ([MSNP18](versions/msnp18.md)) (TODO: Am I right about this?).
* SOAP: Simple Object Access Protocol, A message schema based on XML. That's the kindest thing I can write about it.
* Passport: The Authentication Server and/or Protocol.
* Undefined Behaviour: An intentional blank left in the documentation, basically as a "I am not responsible for what this does to your client or server" warning.
@ -127,7 +129,7 @@ More is to come soon! Hopefully!
An example of the Private Key is `Q1P7W2E4J9R8U3S5` or `YMM8C_H7KCQ2S_KL`.
# Where can I find or edit the source of the articles provided?
The git repository for the project is avaliable at <https://git.kevinthe.horse/yellows111/msnp-wiki>.
The git repository for the project is avaliable at <https://git.computernewb.com/yellows111/msnp-wiki>.
You can submit changes to me via any avaliable contact method as a e-mail merge request,
like those made with [`git format-patch`](https://git-scm.com/docs/git-format-patch).

4
docs/services/abservice.md
View file

@ -1,6 +1,6 @@
# Introduction
The Address Book Service (abservice) is a SOAP (XML) Web Service.
Introduced with [MSNP8](../versions/msnp8.md).
The Address Book Service (abservice), also known as the Address Book Clearing House (ABCH) is a SOAP (XML) Web Service.
It was introduced with [MSNP8](../versions/msnp8.md).
It manages the link(s) between the E-mail Service Address Book and the Forward List (FL).

1
docs/services/abservice/contactinfo.md
View file

@ -10,6 +10,7 @@ This element can contain many children, all of which optional:
* `<contactType>`: The type of contact this is related to:
* `LivePending`: A user yet to authorise you
* `Regular`: A user from another service.
* `Me`: My own user.
* `<displayName>`: The display name for this contact.
* `<puid>`: Unused. Always 0.
* `<CID>`: The Common ID of this contact, which is a signed 64-bit integer.

3
docs/services/passport14.md
View file

@ -2,7 +2,8 @@
Passport 1.4, or "Tweener", as it's sometimes called,
is an HTTP-based authentication system that was introduced with [MSNP8](../versions/msnp8.md).
For [MSNP12](../versions/msnp12.md) and above, read the [Passport (SOAP)](passportsoap.md) article.
For [MSNP12](../versions/msnp12.md) and above, read the [Passport Request Security Token service](rst.md) article.
For [MSNP18](../versions/msnp18.md) and above, read the Request Security Token service, version 2 article.
# Nexus
The Passport Nexus is a server that provides information to other parties about how to use Passport.

5
docs/services/passportsoap.md → docs/services/rst.md
View file

@ -1,10 +1,11 @@
# Introduction
Passport (SOAP), or "Passport 3.0" as it's sometimes called,
The Passport Request Security Token (RST) service, or "Passport 3.0" as it's sometimes called,
is a HTTP-based authentication system that was introduced with [MSNP12](../versions/msnp12.md).
The endpoint is called `RST.srf`, residing on either the `login.passport.net` or `login.live.com` domain.
The endpoint is called `RST.srf`, residing on either the `login.passport.net` or the `login.live.com` domain.
For [MSNP8](../versions/msnp8.md) to [MSNP11](../versions/msnp11.md), read the [Passport 1.4](passport14.md) article.
For [MSNP18](../versions/msnp18.md) and above, read the Request Security Token service, version 2 article. (TODO: Write this, and did I get this right?)
# Client/Request
The following sub-headers are XML elements for the client's request.

4
docs/services/sharingservice.md
View file

@ -1,13 +1,13 @@
# Introduction
The Contact Sharing Service (SharingService) is a SOAP (XML) Web Service.
Introduced with [MSNP13](../versions/msnp13.md).
It was introduced with [MSNP13](../versions/msnp13.md).
It manages the Messenger Service's Allow List (AL), Block List (BL), Reverse List (RL), and Pending List (PL) members.
It's default HTTP URL is `http://byrdr.omega.contacts.msn.com/abservice/SharingService.asmx`.
It's default HTTPS URL is `https://byrdr.omega.contacts.msn.com/abservice/SharingService.asmx`.
This service requires [Passport authentication](passportsoap.md).
This service requires [Passport authentication](rst.md).
Related: [Address Book Service](abservice.md) (for Forward List (FL) members).

11
docs/table_of_commands.md
View file

@ -1,9 +1,10 @@
# Table of Commands
This is a list of all known MSNP commands and their originating version.
For negative responses to these commands, read the [Error Code and HRESULTs](errors_and_hresults.md) article.
| `COMMAND` | Payload (Y/N) | Client to Server (Y/N) | Server to Client (Y/N) | Originating Version | Changed? (version list) |
| ----- | - | - | -| ------ | ----- |
| ------------------------ | - | - | - | -------------------------- | ---- |
| [`VER`](commands/ver.md) | N | Y | N | [MSNP2](versions/msnp2.md) | every MSNP version, but retaining base syntax, removed in MSNP24 |
| [`INF`](commands/inf.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP3](versions/msnp3.md) (removed CTP), [MSNP8](versions/msnp8.md) (Removed; automatic disconnect) |
| [`CVR`](commands/cvr.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP4](versions/msnp4.md) (parameter 7), [MSNP8](versions/msnp8.md) (parameter 8) |
@ -30,14 +31,14 @@ This is a list of all known MSNP commands and their originating version.
| [`LST`](commands/lst.md) | N | Y | Y\*| [MSNP2](versions/msnp2.md) | [MSNP7](versions/msnp7.md) (Added groups support), [MSNP8](versions/msnp8.md) ([SYN](commands/syn.md): removed iterator parameters, condensed all lists into a single parameter, removed List Version), [MSNP10](versions/msnp10.md) (Added prefixes to contact's handle and friendly name, and added a GUID parameter if `ABCHMigrated: 1`. Also changed group IDs to GUIDs.), [MSNP12](versions/msnp12.md) (Added network IDs), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect, use [Address Book Service](services/abservice.md)'s [`ABFindAll`](services/abservice/abfindall.md) and [Contact Sharing Service](services/sharingservice.md)'s [`FindMembership`](services/sharingservice/findmembership.md) instead.), November 2003 (Removed outside of [SYN](commands/syn.md), not really any specific MSNP update, just hard removed with an automatic disconnect.) |
| [`ADD`](commands/add.md) | N | Y | Y | [MSNP2](versions/msnp2.md) | [MSNP7](versions/msnp7.md) (Added groups support), [MSNP10](versions/msnp10.md) (Removed; automatic disconnect, use [ADC](commands/adc.md) instead) |
| [`REM`](commands/rem.md) | N | Y | Y | [MSNP2](versions/msnp2.md) | [MSNP7](versions/msnp7.md) (Added groups support), [MSNP10](versions/msnp10.md) (Replaced user handles with GUIDs if list is the Forward List (FL), and removed list versions from all responses), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect, replaced with RML and [Address Book Service](services/abservice.md)'s [`ABContactDelete`](services/abservice/abcontactdelete.md) and [Contact Sharing Service](services/sharingservice.md)'s [`DeleteMember`](services/sharingservice/deletemember.md) instead) |
| [`FLN`](commands/fln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP14](versions/msnp14.md) (Added Network ID parameter) |
| [`FLN`](commands/fln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP14](versions/msnp14.md) (Added Network ID parameter, Client Capabilities parameter and optional Presense Icon URL parameter), [MSNP16](versions/msnp16.md) (Added support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) |
| [`PNG`](commands/png.md) | N | Y | N | [MSNP2](versions/msnp2.md) | |
| [`QNG`](commands/qng.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP9](versions/msnp9.md) (Added next seconds parameter) |
| [`URL`](commands/url.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP3](versions/msnp3.md) (Added Passport Site ID support as parameter 3), removed `PASSWORD` service), [MSNP5](versions/msnp5.md) (Added `MOBILE` and `CHGMOB` services), [MSNP6](versions/msnp6.md) (Added `PROFILE`, `N2PACCOUNT` and `N2PFUND` services), [MSNP7](versions/msnp7.md) (Added `CHAT` service), [MSNP8](versions/msnp8.md) (Added `ADDRBOOK`, `ADVSEARCH` and `INTSEARCH` services) |
| [`LSG`](commands/lsg.md) | N | Y | Y\*| [MSNP7](versions/msnp7.md) | [MSNP8](versions/msnp8.md) (Removed iterator and List Version parameters from [SYN](commands/syn.md) version), [MSNP10](versions/msnp10.md) (Removed unused parameter, and replaced Group IDs with Group GUIDs if `ABCHMigrated: 1`.), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect, use [Address Book Service](services/abservice.md)'s [`ABFindAll`](services/abservice/abfindall.md) instead.) November 2003 (Removed outside of [SYN](commands/syn.md), not really any specific MSNP update, just hard removed with an automatic disconnect.) |
| [`ADG`](commands/adg.md) | N | Y | N | [MSNP7](versions/msnp7.md) | [MSNP10](versions/msnp10.md) (Removed unused `0` and List Version parameters, and replaced Group IDs with Group GUIDs if `ABCHMigrated: 1`), [MSNP13](versions/msnp13.md) (Removed; automatic disconnect?, use [Address Book Service](services/abservice.md) [`ABGroupAdd`](services/abservice/abgroupadd.md) instead.) |
| [`ILN`](commands/iln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) |
| [`NLN`](commands/nln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) |
| [`ILN`](commands/iln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Added support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) |
| [`NLN`](commands/nln.md) | N | N | Y | [MSNP2](versions/msnp2.md) | [MSNP8](versions/msnp8.md) (Added support for Client Capabilities), [MSNP9](versions/msnp9.md) (Added optional MSNObject parameter), [MSNP14](versions/msnp14.md) (Added Network ID parameter and optional Presence Icon URL parameter), [MSNP16](versions/msnp16.md) (Added support for the Extended Client Capabilities, changing the original Client Capabilities parameter to now be delimited by a colon) |
| [`REA`](commands/rea.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP10](versions/msnp10.md) (Removed; automatic disconnect) |
| [`SND`](commands/snd.md) | N | Y | N | [MSNP2](versions/msnp2.md) | [MSNP3](versions/msnp3.md) (parameters 2 and 3), [MSNP4](versions/msnp4.md) (parameter 4), [MSNP5](versions/msnp5.md) (obsoleted by [SDC](commands/sdc.md)) |
| [`SDC`](commands/sdc.md) | Y | Y | N | [MSNP5](versions/msnp5.md) | |

2
docs/versions/cvr0.md
View file

@ -8,8 +8,6 @@ It is used for requesting the latest client information in case no other protoco
It introduces the commands:
* [CVQ](../commands/cvq.md)
*No error codes were known to be introduced in this version*
*No commands were known to be removed in this version*
# Known changes

17
docs/versions/msnp10.md
View file

@ -9,8 +9,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
*No error codes were known to be introduced in this version*
The following commands were removed in this version:
* [ADD](../commands/add.md) (automatic disconnection)
* [REA](../commands/rea.md) (automatic disconnection?)
@ -49,9 +47,6 @@ The following commands were removed in this version:
This list contains users that have unhandled "contact added you" notifications.
* Added new server-side [OUT](../commands/out.md) reasons: `MIG`, if the server has migrated you to ABCH,
and `TOU`, for not accepting the Service Terms of Use.
* Official Client: Now handles the 604, 914, 916 error codes again,
which were last seen in Client Version 3.6.003x.
Error code 913 is no longer handled after being implemented in Client Version 4.5.
* First protocol version to remove a core command implemented since [MSNP2](msnp2.md) draft ([ADD](../commands/add.md)).
# Client-server communication example
@ -67,9 +62,9 @@ S: CVR 2 6.1.0211 6.1.0211 6.1.0155
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP10 MSNP9 CVR0
S: VER 4 MSNP10
@ -122,9 +117,9 @@ C: CHG 9 NLN
S: CHG 9 NLN
S: OUT MIG
```
Server disconnects client
Server disconnects client.
Client opens a connection to 10.0.0.5:1863 (from stored server)
Client opens a connection to `10.0.0.5:1863` (from stored server).
```
C: VER 10 MSNP10 MSNP9 CVR0
S: VER 10 MSNP10
@ -174,8 +169,8 @@ C: CHG 15 NLN
S: CHG 15 NLN
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

19
docs/versions/msnp11.md
View file

@ -12,8 +12,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
*No error codes were known to be introduced in this version*
*No commands were known to be removed in this version*
# Known changes
@ -39,14 +37,13 @@ It introduces the notification service commands:
[`<NotificationData>`](../files/notification.md) sub-documents are supported for spaces (blogs).
* Official Client: Messenger Config requests now support regional arguments via SOAP.
* Official Client: [OUT](../commands/out.md) SSD is actually implemented now.
* Official Client: Error code 913 is handled again after being removed last version. Why?
# Client-server communication example
*NOTE: This has been line-breaked.
Lines beginning with `..` followed by a space are continuations of the previous line.*
```
C: VER 1 MSNP10 MSNP9 CVR0
S: VER 1 MSNP10
C: VER 1 MSNP11 MSNP10 MSNP9 CVR0
S: VER 1 MSNP11
C: CVR 2 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: CVR 2 6.1.0211 6.1.0211 6.1.0155
.. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe
@ -54,12 +51,12 @@ S: CVR 2 6.1.0211 6.1.0211 6.1.0155
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863 (from stored server)
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP10 MSNP9 CVR0
S: VER 4 MSNP10
C: VER 4 MSNP11 MSNP10 MSNP9 CVR0
S: VER 4 MSNP11
C: CVR 5 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com
S: CVR 5 6.1.0211 6.1.0211 6.1.0155
.. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe
@ -152,8 +149,8 @@ S: NOT 1264
</NOTIFICATION>
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

21
docs/versions/msnp12.md
View file

@ -8,8 +8,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
*No error codes were known to be introduced in this version*
*No commands were known to be removed in this version*
# Known changes
@ -17,8 +15,10 @@ It introduces the notification service commands:
* Network IDs are introduced, each bit represents a contact's service, with bit 0/decimal 1 being MSNP.
* Switchboard commands [JOI](../commands/joi.md) and [IRO](../commands/iro.md) have a new parameter for the
[Client Capabilities](../files/client_capabilities.md) of the relevant user.
* [LST](../commands/lst.md) has the Network ID after the list bits (on any list), but before the Group ID (if on Forward List (FL)).
* Official Client: Uses Passport 3.0 (via the Microsoft Identity Common Runtime Library).
* [LST](../commands/lst.md) has the Network ID after the list bits (on any list),
but before the Group ID (if contact is on the Forward List (FL)).
* Official Client: Now uses the [Passport Request Security Token service](../services/rst.md),
via the Microsoft Identity Common Runtime Library.
* Official Client: Dropped support for older operating systems, Now requires Windows XP or higher.
* Official Client: Now supports Voice Clips, which can be disabled in the [Messenger Config](../services/msgrconfig.md).
* Official Client: [Shield Configuration Data](../files/shields.md) can now block file hashes and
@ -37,9 +37,9 @@ S: CVR 2 6.1.0211 6.1.0211 6.1.0155
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP12 MSNP11 MSNP10 CVR0
S: VER 4 MSNP12
@ -49,10 +49,11 @@ S: CVR 5 6.1.0211 6.1.0211 6.1.0155
.. http://messenger.msn.com
C: USR 6 TWN I example@hotmail.com
```
*The HTTPS interlude is described in the [Passport (SOAP)](../services/passportsoap.md) article.*
*The HTTPS interlude is described in the
[Passport Request Security Token service](../services/rst.md) article.*
```
S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
C: USR 7 TWN S $(xmldecode(passportsoap.BinarySecurityToken#Compact1))
C: USR 7 TWN S $(xmldecode(RequestSecurityTokenResponse.BinarySecurityToken#Compact1))
S: USR 7 OK example@hotmail.com 1 0
S: SBS 0 null
S: MSG Hotmail Hotmail 465
@ -99,8 +100,8 @@ C: UUX 11 53
S: UUX 11 0
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

13
docs/versions/msnp13.md
View file

@ -13,8 +13,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
*No error codes were known to be introduced in this version*
The following commands were removed in this version:
* [ADC](../commands/adc.md) (automatic disconnection)
* [ADG](../commands/adc.md) (automatic disconnection)
@ -33,7 +31,7 @@ The following commands were removed in this version:
The unused parameter from [MSNP3](msnp3.md) and the current server parameter from [MSNP7](msnp7.md)
have been replaced with two new parameters, one containing `U`, and one containing a `D`.
The use of these parameters is unknown.
* The [Passport (SOAP)](../services/passportsoap.md) authentication request
* The [Passport Request Security Token service](../services/rst.md) authentication request
will now include a request for few more security tokens,
notably `contacts.msn.com` for the [Address Book Service](../services/abservice.md).
* Replaced [SYN](../commands/syn.md) with both the
@ -90,9 +88,9 @@ S: CVR 2 8.0.0566 8.0.0566 8.0.0566
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 U D
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP13 CVR0
S: VER 4 MSNP13
@ -102,7 +100,8 @@ S: CVR 5 8.0.0566 8.0.0566 8.0.0566
.. http://ideas.live.com
C: USR 6 TWN I example@hotmail.com
```
*The HTTPS interlude is described in the [Passport (SOAP)](../services/passportsoap.md) article.*
*The HTTPS interlude is described in the
[Passport Request Security Token service](../services/rst.md) article.*
```
S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
S: GCF 0 201
@ -117,7 +116,7 @@ S: GCF 0 201
</config>
</Policy>
</Policies>
C: USR 7 TWN S $(xmldecode(passportsoap.BinarySecurityToken#Compact1))
C: USR 7 TWN S $(xmldecode(RequestSecurityTokenResponse.BinarySecurityToken#Compact1))
S: USR 7 OK example@hotmail.com 1 0
S: SBS 0 null
S: MSG Hotmail Hotmail 481

18
docs/versions/msnp14.md
View file

@ -11,8 +11,6 @@ It introduces the notificaiton service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
*No error codes were known to be introduced in this version*
*No commands were known to be removed in this version*
# Known changes
@ -22,7 +20,10 @@ It introduces the notificaiton service commands:
* [RNG](../commands/rng.md) and [XFR](../commands/xfr.md) SB commands now have an extra parameter
to specify if the address should be connected to directly or only via the HTTP Gateway.
* [ILN](../commands/iln.md), [NLN](../commands/nln.md) and [FLN](../commands/fln.md)
now have an extra parameter for the Network ID of the network that generated the new status.
now have a few extra parameters:
* One for the Network ID of the network that generated the new status.
* One for the current Client Capabilities of the user.
* Finally, one to specify what icon to use to denote a user from another service.
* Official Client: Yahoo! Messenger interoperability is now supported.
The [FQY](../command/fqy.md) command is used to discover if a user is from the Yahoo! Messenger network.
This is represented in the [Address Book Service](../services/abservice.md) as a email-only contact
@ -30,8 +31,6 @@ It introduces the notificaiton service commands:
This is also represented in the [Contact Sharing Service](../services/sharingservice.md) as a e-mail membership,
with the `MSN.IM.BuddyType` annotation set to `32:`.
The Network ID 32 (bit 6) is used to specify that this user is from the Yahoo! Messenger service.
* [ILN](../commands/iln.md) and [NLN](../commands/nln.md) now include a new parameter
that specifies what icon to use to denote a user from another service.
# Client-server communication example
*NOTE: This has been line-breaked.
@ -46,9 +45,9 @@ S: CVR 2 8.0.0566 8.0.0566 8.0.0566
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 U D
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP14 MSNP13 CVR0
S: VER 4 MSNP14
@ -58,7 +57,8 @@ S: CVR 5 8.0.0566 8.0.0566 8.0.0566
.. http://ideas.live.com
C: USR 6 TWN I example@hotmail.com
```
*The HTTPS interlude is described in the [Passport (SOAP)](../services/passportsoap.md) article.*
*The HTTPS interlude is described in the
[Passport Request Security Token service](../services/rst.md) article.*
```
S: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
S: GCF 0 201
@ -73,7 +73,7 @@ S: GCF 0 201
</config>
</Policy>
</Policies>
C: USR 7 TWN S $(xmldecode(passportsoap.BinarySecurityToken#Compact1))
C: USR 7 TWN S $(xmldecode(RequestSecurityTokenResponse.BinarySecurityToken#Compact1))
S: USR 7 OK example@hotmail.com 1 0
S: SBS 0 null
S: MSG Hotmail Hotmail 465

55
docs/versions/msnp2.md
View file

@ -26,7 +26,7 @@ It introduces the notification service commands:
* [OUT](../commands/out.md)
* [PNG](../commands/png.md) (not in draft)
* [QNG](../commands/qng.md) (not in draft)
* [REA](../commands/rea.md) (not in draft, surprisingly)
* [REA](../commands/rea.md) (not in draft, despite alluding to it)
* [REM](../commands/rem.md)
* [RNG](../commands/rng.md)
* [SND](../commands/snd.md) (not in draft)
@ -48,51 +48,6 @@ It introduces the switchboard service commands:
* [OUT](../commands/out.md)
* [USR](../commands/usr.md)
It introduces the error codes:
* 100 (not in draft)
* 146 (not in draft)
* 200
* 201
* 205
* 206
* 207
* 208 (draft only)
* 209
* 210
* 211 (not in draft)
* 215 (draft only)
* 216
* 218
* 219
* 280
* 281
* 300
* 302
* 500
* 501 (draft only)
* 503 (not in draft)
* 510
* 520
* 600
* 601
* 602 (draft only)
* 603 (draft only)
* 604 (draft only)
* 707
* 711 (draft only)
* 712
* 713
* 714
* 715 (draft only)
* 717 (draft only)
* 911
* 912 (not in draft)
* 913 (draft only)
* 914 (not in draft)
* 918 (not in draft)
* 919 (not in draft)
* 920
*No commands were known to be removed in this version*
# Known changes
@ -108,9 +63,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP2 CVR0
S: VER 4 MSNP2
@ -147,8 +102,8 @@ S: REA 13 5 example@hotmail.com example%20user
S: FLN anotheruser@hotmail.com
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

42
docs/versions/msnp3.md
View file

@ -8,14 +8,6 @@ It introduces the notification service commands:
*No switchboard or dispatch commands were known to be introduced in this version*
It introduces the error codes:
* 131
* 212
* 217
* 716
* 800
* 917
*No commands were known to be removed in this version*
# Known changes
@ -53,32 +45,6 @@ It introduces the error codes:
* Official Client: Removed [URL](../commands/url.md) service `PASSWORD`.
* Official Client: Disabled inviting people to the service (needs confirmation).
## Changes to error codes
*Only applies for the Official Client.*
### Re-added
*Where the parenthesis are the last version that had the error.*
* 208 (draft)
* 215 (draft)
* 501 (draft)
* 604 (draft)
* 715 (draft)
* 913 (draft)
* 917 (draft)
### Removed
* 146
* 206
* 207
* 211
* 218
* 503
* 510
* 914
* 918
* 919
# Client-server communication example
```
C: VER 1 MSNP3 MSNP2 CVR0
@ -88,9 +54,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP3 MSNP2 CVR0
S: VER 4 MSNP3
@ -134,8 +100,8 @@ C: SND 12 anotheruser@hotmail.com 0x0409 MSMSGS
S: SND 12 OK
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

22
docs/versions/msnp4.md
View file

@ -5,8 +5,6 @@ It was introduced officially in Client Version 2.1.1047.
# Command information
*No commands for any service were known to be introduced in this version*
*No error codes were known to be introduced in this version*
*No commands were known to be removed in this version*
# Known changes
@ -19,18 +17,6 @@ It was introduced officially in Client Version 2.1.1047.
which when sent as a [USR](../commands/usr.md) response, shows the
"Sorry, this Kids Passport account does not have permission to access this service" dialog.
## Changes to error codes
*Only applies for the Official Client.*
### Re-added
*Where the parenthesis are the last version that had the error.*
* 208 (draft)
* 500
### Removed
None.
# Client-server communication example
```
C: VER 1 MSNP4 MSNP3 CVR0
@ -40,9 +26,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP4 MSNP3 CVR0
S: VER 4 MSNP4
@ -82,8 +68,8 @@ C: SND 10 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS
S: SND 10 OK
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

32
docs/versions/msnp5.md
View file

@ -12,9 +12,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
It introduces the error codes:
* 922
*No commands were known to be removed in this version*
# Known changes
@ -38,27 +35,6 @@ It introduces the error codes:
which when sent as a [USR](../commands/usr.md) response, shows the
"Sorry, you can not sign in until your verify that (user handle) really belongs to you" dialog.
## Changes to error codes
*Only applies for the Official Client.*
### Re-added
*Where the parenthesis are the last version that had the error.*
* 211 ([MSNP2](msnp2).md)
* 503
* 510
* 914 ([MSNP2](msnp2).md)
* 919 ([MSNP2](msnp2).md)
### Removed
* 131
* 209
* 212
* 500
* 501
* 912
* 913
# Client-server communication example
```
C: VER 1 MSNP5 MSNP4 CVR0
@ -68,9 +44,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP5 MSNP4 CVR0
S: VER 4 MSNP5
@ -133,8 +109,8 @@ S: PRP 10 7 PHH 123%20(4567)
S: BPR 8 anotheruser@hotmail.com PHH 1%20(222)%20333%204444
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

26
docs/versions/msnp6.md
View file

@ -10,12 +10,7 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
*No error codes were known to be introduced in this version*
It introduces the error codes:
* 540
* 915
* 916
*No commands were known to be removed in this version*
# Known changes
(from [MSNP5](msnp5.md)):
@ -31,17 +26,6 @@ It introduces the error codes:
* Official Client: Added new [URL](../commands/url.md) services `PROFILE`, `N2PACCOUNT` and `N2PFUND`.
* Official Client: Error 924 dialog changed to the unverified but still can use service one. Not sure why.
## Changes to error codes
*Only applies for the Official Client.*
### Re-added
None.
### Removed
* 215
* 219
* 919
# Client-server communication example
```
C: VER 1 MSNP6 MSNP5 MSNP4 CVR0
@ -51,9 +35,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP6 MSNP5 MSNP4 CVR0
S: VER 4 MSNP6
@ -110,8 +94,8 @@ S: IPG 478
</NOTIFICATION>
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

43
docs/versions/msnp7.md
View file

@ -11,17 +11,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
It introduces the error codes:
* 224
* 225
* 226
* 229
* 230
* 502
* 710
* 921
* 924
*No commands were known to be removed in this version*
# Known changes
@ -41,30 +30,6 @@ It introduces the error codes:
* Official Client: Added new [URL](../commands/url.md) service `CHAT`.
* Official Client: Removed [URL](../commands/url.md) services `N2PACCOUNT` and `N2PFUND`.
## Changes to error codes
*Only applies for the Official Client.*
### Re-added
*Where the parenthesis are the last version that had the error.*
* 131
* 146
* 603
* 604
* 913 ([MSNP4](msnp4.md))
* 918 ([MSNP2](msnp2.md))
### Removed
* 503
* 601
* 604
* 715
* 716
* 914
* 915
* 916
* 920
# Client-server communication example
```
C: VER 1 MSNP7 MSNP6 MSNP5 MSNP4 CVR0
@ -74,9 +39,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP7 MSNP6 MSNP5 MSNP4 CVR0
S: VER 4 MSNP7
@ -142,8 +107,8 @@ C: RMG 14 2
S: RMG 14 14 2
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

18
docs/versions/msnp8.md
View file

@ -5,8 +5,6 @@ It was introduced officially in Client Version 5.0.0537.
# Command information
*No commands for any service were known to be introduced in this version*
*No error codes were known to be introduced in this version*
The following commands were removed in this version:
* [INF](../commands/inf.md) (automatic disconnection)
* [FND](../commands/fnd.md) (`502` by July 2003, see Known changes for client details.)
@ -43,7 +41,7 @@ The following commands were removed in this version:
You can now tell other clients what features you support.
* Official Client: Connectivity field added to application requests
to notify the other user about what the network conditions are.
* Official Client: Introduced ABCH (Address Book Clearing House) support.
* Official Client: Introduced support for the [Address Book Service](../services/abservice.md).
The URL is gathered from `svcs.microsoft.com`.
`abch_config.asp` provides an XML document with a `<abchconfig>` element.
It has a `<url>` element containing the service URL, a `<refresh>` element,
@ -51,12 +49,6 @@ The following commands were removed in this version:
`http://contacts.msn.com/abservice/abservice.asmx`, `0` and `0.0` respectively.
* Official Client: Added new [URL](../commands/url.md) services `ADDRBOOK`, `ADVSEARCH` and `INTSEARCH`
## Changes to error codes
TODO: this section
Added: 603
# Client-server communication example
*NOTE: This has been line-breaked.
Lines beginning with `..` followed by a space are continuations of the previous line.*
@ -70,9 +62,9 @@ S: CVR 2 5.0.0537 5.0.0537 1.0.0863
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP8 CVR0
S: VER 4 MSNP8
@ -126,8 +118,8 @@ S: NLN NLN anotheruser@hotmail.com another%20user 2
S: NLN NLN anotheruser@hotmail.com another%20user 28
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

13
docs/versions/msnp9.md
View file

@ -8,9 +8,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version*
It introduces the error codes:
* 282
The following commands were removed in this version:
* [PAG](../commands/pag.md) (returns 715)
* [LST](../commands/lst.md) (Only client-initated, the one in [SYN](../commands/syn.md) is kept,
@ -26,8 +23,6 @@ The following commands were removed in this version:
* Switchboard [MSG](../commands/msg.md): Acknowledgement type D added.
Can respond with either [ACK](../commands/ack.md), error 282, or possibly any other error codes.
* [NOT](../commands/not.md): Extended notifications are now supported via the `<TEXTX>` element.
* Official Client: Error 603 is handled again after being removed in Client Version 5.0.
Error code 711 is no longer handled after being implemented in Client Version 5.0.
* Official Client: Supports the [Messenger Config](../services/msgrconfig.md) XML service, replacing `svcs.microsoft.com`.
# Client-server communication example
@ -43,9 +38,9 @@ S: CVR 2 6.0.0602 6.0.0602 6.0.0268
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server
Client disconnects from server.
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`.
```
C: VER 4 MSNP9 MSNP8 CVR0
S: VER 4 MSNP9
@ -114,8 +109,8 @@ S: NOT 457
</NOTIFICATION>
C: OUT
```
Client disconnects from server
Client disconnects from server.
```
S: OUT
```
Server disconnects client
Server disconnects client.

6
package-lock.json generated
View file

@ -1,15 +1,15 @@
{
"name": "yellows-msnp-wiki",
"version": "0.1.4",
"version": "0.2.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "yellows-msnp-wiki",
"version": "0.1.4",
"version": "0.2.0",
"license": "GFDL-1.3-or-later",
"dependencies": {
"yiki": "git+https://git.kevinthe.horse/yellows111/yiki.git#semver:*"
"yiki": "git+https://git.computernewb.com/yellows111/yiki.git#semver:*"
}
},
"node_modules/@liquify/prettify": {

2
package.json
View file

@ -1,6 +1,6 @@
{
"name": "yellows-msnp-wiki",
"version": "0.1.4",
"version": "0.2.0",
"description": "The yellows111 MSNP wiki that aims for accuracy.",
"author": "yellows111",
"license": "GFDL-1.3-or-later",

1
templates/command.md
View file

@ -39,7 +39,6 @@ It may also lead to an Instant Disconnection.*
C: xxx 4 something wrong to go here
S: 201
```
Server disconnects client.
# Known changes

10
templates/msnpver.md
View file

@ -1,14 +1,10 @@
# Introduction
MSNPx is the nth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version y.y.yyyy.
# Command information
*No commands for any service were known to be introduced in this version*
*No error codes were known to be introduced in this version*
*No commands were known to be removed in this version*
# Known changes
@ -26,11 +22,9 @@ S: CVR 2 6.0.0602 6.0.0602 6.0.0268 http://download.microsoft.com/download/8/a/4
C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863
```
Client disconnects from server.
Client disconnects from server
Client opens a connection to 10.0.0.5:1863
Client opens a connection to `10.0.0.5:1863`
```
C: VER 4 MSNPx MSNPx-1 CVR0
S: VER 4 MSNPx