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

5
docs/commands/ack.md
View file

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

5
docs/commands/adc.md
View file

@ -154,14 +154,13 @@ S: 224 12
``` ```
C: ADC 13 PL N=anotheruser@hotmail.com C: ADC 13 PL N=anotheruser@hotmail.com
``` ```
Server disconnects client. Server disconnects client.
## Removed ## Command removed
*Since [MSNP13](../versions/msnp13.md).*
``` ```
C: ADC 14 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com C: ADC 14 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com
``` ```
Server disconnects client. Server disconnects client.
## Asynchronous update ## 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 C: ADD 11 RL anotheruser@hotmail.com anotheruser@hotmail.com
``` ```
Server disconnects client. Server disconnects client.
## Removed ## Command removed
*Since [MSNP10](../versions/msnp10.md).*
``` ```
C: ADD 12 FL anotheruser@hotmail.com anotheruser@hotmail.com C: ADD 12 FL anotheruser@hotmail.com anotheruser@hotmail.com
``` ```
Server disconnects client. Server disconnects client.
## Asynchronous update ## Asynchronous update

8
docs/commands/adg.md
View file

@ -55,7 +55,6 @@ C: ADG 3 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA 0 .. AAAAAAA 0
``` ```
Server disconnects client. Server disconnects client.
## Without list versions ## Without list versions
@ -89,7 +88,6 @@ C: ADG 7 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA .. AAAAAAA
``` ```
Server disconnects client. Server disconnects client.
### With group GUIDs ### With group GUIDs
@ -121,7 +119,13 @@ C: ADG 11 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA .. AAAAAAA
``` ```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: ADG 12 Example%20Group
```
Server disconnects client. Server disconnects client.
# Known changes # 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. The response of this command sent after the [IRO](iro.md) list has been sent.
# Client/Request # 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. 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. Where `cookie` is the `cookie` from the [RNG](rng.md) command sent to you.
@ -24,8 +25,11 @@ Where `OK` is always `OK`.
# Examples # Examples
## Answering a RNG ## 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 C: ANS 1 example@hotmail.com 123456789.123456789.123456789 987654321
S: IRO 1 1 1 anotheruser@hotmail.com another%20user S: IRO 1 1 1 anotheruser@hotmail.com another%20user
S: ANS 1 OK S: ANS 1 OK
@ -36,7 +40,6 @@ S: ANS 1 OK
``` ```
C: ANS 2 example@hotmail.com bad data C: ANS 2 example@hotmail.com bad data
``` ```
Server disconnects client. Server disconnects client.
## Invalid context (Notification Server) ## Invalid context (Notification Server)
@ -44,7 +47,6 @@ Server disconnects client.
``` ```
C: ANS 3 example@hotmail.com wrong server C: ANS 3 example@hotmail.com wrong server
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

4
docs/commands/blp.md
View file

@ -36,12 +36,10 @@ S: 218 4
``` ```
## Invalid argument ## 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 C: BLP 5 CL
S: 201 5
``` ```
Server disconnects client.
# Known changes # Known changes
* [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode. * [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 C: BPR example@hotmail.com
``` ```
Server disconnects client.
# Known changes # Known changes
* [MSNP8](../versions/msnp8.md): Removed the user's handle when used in [SYN](syn.md). * [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 C: BYE 1
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

10
docs/commands/cal.md
View file

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

14
docs/commands/chg.md
View file

@ -28,22 +28,23 @@ add additional information related to your user. Requires that `flags` MUST be s
The MSNObject itself is a XML-like element. The MSNObject itself is a XML-like element.
## Status explanations ## Status explanations
All statuses except `HDN` and `FLN` will treat you as online. All statuses except `HDN` and `FLN` will treat you as online.
Which means all users on your Allow List (AL) and Reverse List (RL) Which means all users on your Allow List (AL) and Reverse List (RL)
will get all presence changes via the NLN command. will get all presence changes via the NLN command.
The statuses `HDN` and `FLN` will treat you as offline. The statuses `HDN` and `FLN` will treat you as offline.
Which means all users on your Allow List (AL) and Reverse List (RL) Which means all users on your Allow List (AL) and Reverse List (RL)
will get a FLN command instead of an NLN command. will get a FLN command instead of an NLN command.
Also, all attempts to create a Switchboard session will fail automatically, 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 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. 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 # Server/Response
`CHG TrID status {flags} {msnobj}` `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 # 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 .. %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 S: CHG 0 FLN
``` ```
@ -88,7 +89,6 @@ S: CHG 0 FLN
``` ```
C: CHG 4 HOT C: CHG 4 HOT
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

13
docs/commands/chl.md
View file

@ -19,17 +19,17 @@ that is concatenated with the client's Private Key.
# Examples # Examples
## From server at any time ## Client-initiated challenge
```
S: CHL 0 12345678901234567890
```
## Requested challenge
``` ```
C: CHL 1 C: CHL 1
S: CHL 1 12345678901234567890 S: CHL 1 12345678901234567890
``` ```
## From server at any time
```
S: CHL 0 12345678901234567890
```
## Challenge timeout ## Challenge timeout
``` ```
S: CHL 0 12345678901234567890 S: CHL 0 12345678901234567890
@ -38,7 +38,6 @@ S: CHL 0 12345678901234567890
``` ```
S: OUT S: OUT
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 `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". 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://download.microsoft.com/download/msnmessenger/install/5.0/w98nt42kmexp/en-us/setupdl.exe
.. http://messenger.microsoft.com .. http://messenger.microsoft.com
``` ```
Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`. Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`.
## New ## 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://msgr.dlservice.microsoft.com/download/5/d/9/5d9bb5b2-49c7-4890-94ab-d1d5e44a0e6d/Install_MSN_Messenger.exe
.. http://messenger.msn.com .. http://messenger.msn.com
``` ```
Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`. Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`.
## Invalid client identification or 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 S: 710 5
``` ```
## Invalid CVR ## Invalid parameters
``` ```
C: CVQ 6 spaghetti C: CVQ 6 spaghetti
S: 731 6 S: 731 6
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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://download.microsoft.com/download/msnmessenger/install/5.0/w98nt42kmexp/en-us/setupdl.exe
.. http://messenger.microsoft.com .. http://messenger.microsoft.com
``` ```
Client asks if user would like to update, and stays connected. Client asks if user would like to update, and stays connected.
## Pre-login ## 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://msgr.dlservice.microsoft.com/download/5/d/9/5d9bb5b2-49c7-4890-94ab-d1d5e44a0e6d/Install_MSN_Messenger.exe
.. http://messenger.msn.com .. http://messenger.msn.com
``` ```
Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`. Client disconnects from server, since it sees that `minimum-allowed` is above it's `client-version`.
## Invalid client identification or 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 S: 710 5
``` ```
## Invalid CVR ## Invalid parameters
``` ```
C: CVR 6 spaghetti C: CVR 6 spaghetti
S: 731 6 S: 731 6
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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. This command can not be sent from the client.
# Server/Response # 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 `user-handle` is the related user's handle.
Where `network-id` is the Network Identification Number that this user is from. Where `network-id` is the Network Identification Number that this user is from.
Added since [MSNP14](../versions/msnp14.md). 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 # Examples
## User goes offline ## User goes offline
@ -26,10 +35,16 @@ Added since [MSNP14](../versions/msnp14.md).
S: FLN anotheruser@hotmail.com S: FLN anotheruser@hotmail.com
``` ```
### With Network IDs ### With Network IDs and Preesense Icon URLs and Client Capabilities
*Since [MSNP14](../versions/msnp14.md).* *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 ## Invalid context
@ -37,8 +52,11 @@ S: FLN anotheruser@hotmail.com 1
``` ```
C: FLN Hotmail C: FLN Hotmail
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 S: 301 4
``` ```
## Removed ## Command removed
``` ```
C: FND 5 fname=Another lname=User city=* state=* country=US C: FND 5 fname=Another lname=User city=* state=* country=US
S: 502 5 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, No whitespace is allowed in FQY's payload and the payload size reflects this,
and is set to the correct value.* and is set to the correct value.*
## User on another service ## User on the same service
``` ```
C: FQY 1 53 C: FQY 1 53
<ml> <ml>
@ -57,7 +57,7 @@ S: FQY 1 59
</ml> </ml>
``` ```
## User on the same service ## User on another service
``` ```
C: FQY 2 53 C: FQY 2 53
<ml> <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. It gets configuration data from a file on the server.
# Client/Request # 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` `GCF TrID filename`
Where filename is the file to retrieve. Only `Shields.xml` is known to be this parameter. 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 C: GCF 3 Shields.xml
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

11
docs/commands/gtc.md
View file

@ -36,12 +36,17 @@ S: 218 4
``` ```
## Invalid argument ## 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 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 # Known changes
* [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode. * [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 # Examples
## Wihout anything special ## Only with status
``` ```
C: CHG 1 NLN C: CHG 1 NLN
S: 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 C: ILN 6 FLN example@hotmail.com example%20user
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

1
docs/commands/ims.md
View file

@ -33,7 +33,6 @@ S: IMS 2 0 OFF
``` ```
C: IMS 3 TOMORROW C: IMS 3 TOMORROW
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 # Server/Response
`INF TrID security-package {security-package ...}` `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 # Examples

1
docs/commands/ipg.md
View file

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

1
docs/commands/iro.md
View file

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

1
docs/commands/joi.md
View file

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

19
docs/commands/lst.md
View file

@ -33,7 +33,7 @@ Added since [MSNP7](../versions/msnp7.md).
## In SYN ## In SYN
### First generation ### First generation parameters
*Applies for [MSNP2](../versions/msnp2.md) to [MSNP6](../versions/msnp6.md).* *Applies for [MSNP2](../versions/msnp2.md) to [MSNP6](../versions/msnp6.md).*
Same as the response [Outside of SYN](#outside-of-syn). 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, 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`. 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)* *Applies for [MSNP8](../versions/msnp8.md) and [MSNP9](../versions/msnp9.md)*
`LST user-handle stored-friendly-name list-bits {groups}` `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, 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`. 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`.* *Applies for [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 0`.*
`LST N=user-handle F=stored-friendly-name list-bits {groups}` `LST N=user-handle F=stored-friendly-name list-bits {groups}`
Same parameters as the [second generation](#second-generation). 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`.* *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}` `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, 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. 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).* *Applies for [MSNP12](../versions/msnp12.md).*
`LST N=user-handle F=stored-friendly-name C=contact-guid list-bits network-id {groupGuids}` `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 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).* *Only in [MSNP8](../versions/msnp8.md) and [MSNP9](../versions/msnp9.md).*
``` ```
C: SYN 5 0 C: SYN 5 0
@ -143,7 +143,7 @@ S: LSG 0 Other%20Contacts 0
S: LST anotheruser@hotmail.com another%20user 11 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`.* *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 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`.* *Only in [MSNP10](../versions/msnp10.md) and [MSNP11](../versions/msnp11.md) with `ABCHMigrated: 1`.*
``` ```
C: SYN 7 0 0 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 S: LST N=anotheruser@hotmail.com F=another%20user C=c1f9a363-4ee9-4a33-a434-b056a4c55b98 11 d6deeacd-7849-4de4-93c5-d130915d0042
``` ```
### Using fifth generation parameters
### Using fifth generation
*Only in [MSNP12](../versions/msnp12.md).* *Only in [MSNP12](../versions/msnp12.md).*
``` ```
C: SYN 8 0 0 C: SYN 8 0 0

17
docs/commands/msg.md
View file

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

5
docs/commands/nak.md
View file

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

3
docs/commands/nln.md
View file

@ -42,7 +42,7 @@ Optional. Added since [MSNP14](../versions/msnp14.md).
# Examples # Examples
## Wihout anything special ## Only with status
``` ```
S: NLN NLN anotheruser@example.com another%20user 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 C: NLN FLN example@hotmail.com example%20user
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

1
docs/commands/not.md
View file

@ -124,7 +124,6 @@ S: NOT 694
``` ```
C: NOT 1 0 C: NOT 1 0
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 C: OUT
S: OUT S: OUT
``` ```
Server disconnects client. Server disconnects client.
## Logged in from another client ## Logged in from another client
@ -44,7 +43,7 @@ S: OUT OTH
S: OUT SSD S: OUT SSD
``` ```
## ABCH Migration ## ABCH migration
*Only in [MSNP10](../versions/msnp10.md).* *Only in [MSNP10](../versions/msnp10.md).*
``` ```
S: OUT MIG S: OUT MIG
@ -56,7 +55,7 @@ S: OUT MIG
S: OUT TOU S: OUT TOU
``` ```
## Forced Reconnect ## Forced reconnect
*Since [MSNP11](../versions/msnp11.md).* *Since [MSNP11](../versions/msnp11.md).*
``` ```
S: OUT RCT 6 S: OUT RCT 6

4
docs/commands/pag.md
View file

@ -1,7 +1,7 @@
# Introduction # Introduction
`PAG` is a command introduced with [MSNP5](../versions/msnp5.md). `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. 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). 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 S: 800 5
``` ```
## Removed ## Command removed
*Since [MSNP9](../versions/msnp9.md).* *Since [MSNP9](../versions/msnp9.md).*
``` ```
C: PAG 6 anotheruser@hotmail.com 61 C: PAG 6 anotheruser@hotmail.com 61

3
docs/commands/pgd.md
View file

@ -1,7 +1,7 @@
# Introduction # Introduction
`PGD` is a command introduced with [MSNP9](../versions/msnp9.md). `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. 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). 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 C: PGD 9 anotheruser@hotmail.com W 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT> <TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

4
docs/commands/png.md
View file

@ -1,7 +1,7 @@
# Introduction # Introduction
`PNG` is a command introduced with [MSNP2](../versions/msnp2.md). `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. 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 # Examples
## Client-sent ## Client-initiated
``` ```
C: PNG C: PNG
S: QNG S: QNG

2
docs/commands/prp.md
View file

@ -47,7 +47,6 @@ S: 715 2
``` ```
C: PRP 3 NICE Y C: PRP 3 NICE Y
``` ```
Server disconnects client. Server disconnects client.
## Property value is too long ## 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 C: PRP 4 PHM this%20is%20way%20too%20long%20of%20a
.. %20phone%20number%20not%20like%20it%20is%20one%20anyway... .. %20phone%20number%20not%20like%20it%20is%20one%20anyway...
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 # Examples
## Server-reply, old ## Server reply, without next seconds parameter
*Only in [MSNP2](../versions/msnp2.md) to [MSNP8](../versions/msnp8.md).*
``` ```
C: PNG C: PNG
S: QNG S: QNG
``` ```
## Server-reply, new ## Server reply, with next seconds parameter
*Since [MSNP9](../versions/msnp9.md).* *Since [MSNP9](../versions/msnp9.md).*
``` ```
C: PNG C: PNG
@ -33,7 +34,6 @@ S: QNG 50
``` ```
C: QNG C: QNG
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

1
docs/commands/qry.md
View file

@ -62,7 +62,6 @@ C: QRY 2 msmsgs@msnmsgr.com 32
8ba1bb9d6dbf624fee31a2053af5fdd0 8ba1bb9d6dbf624fee31a2053af5fdd0
S: 540 2 S: 540 2
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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. 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 # Client/Request
`REA TrID user-handle new-friendly-name` `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 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). [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. Where `new-friendly-name` is the friendly name you'd like to set,
Subject to server-side restrictions. which may be rejected for any reason by the server.
# Server/Response # Server/Response
`REA TrID list-version user-handle new-friendly-name` `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 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 C: REA 3 example@hotmail.com bad
S: 209 3 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 C: REA 4 ghost@hotmail.com ghost
S: 216 4 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 C: REA 5 example@hotmail.com new%20name%201
S: REA 5 258 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 C: REG 3 30 example%20out%20of%20bounds%20group 0
``` ```
Server disconnects client.
Server disconnects client
### Group name extremely long ### Group name extremely long
*NOTE: This has been line-breaked. *NOTE: This has been line-breaked.
@ -56,7 +55,6 @@ C: REG 4 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAA 0 .. AAAAAAAAA 0
``` ```
Server disconnects client. Server disconnects client.
## Without list versions ## Without list versions
@ -80,7 +78,6 @@ S: 224 6
``` ```
C: REG 7 30 still%20out%20of%20bounds C: REG 7 30 still%20out%20of%20bounds
``` ```
Server disconnects client. Server disconnects client.
### Group name extremely long ### Group name extremely long
@ -91,7 +88,6 @@ C: REG 8 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAA .. AAAAAAAAA
``` ```
Server disconnects client. Server disconnects client.
### With group GUIDs ### With group GUIDs
@ -113,7 +109,6 @@ S: 224 10
``` ```
C: REG 11 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! very%20invalid%20GUID%20there C: REG 11 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! very%20invalid%20GUID%20there
``` ```
Server disconnects client. Server disconnects client.
### Group name extremely long ### Group name extremely long
@ -124,7 +119,13 @@ C: REG 12 d6deeacd-7849-4de4-93c5-d130915d0042 AAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA .. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
``` ```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: REG 13 f60efbe7-94af-4b16-b926-e4e10878d329 Other%20Friends
```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

6
docs/commands/rem.md
View file

@ -111,7 +111,13 @@ S: 225 11
``` ```
C: REM 12 RL anotheruser@hotmail.com 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. Server disconnects client.
## Asynchronous update ## Asynchronous update

10
docs/commands/rmg.md
View file

@ -51,7 +51,6 @@ S: 230 3
``` ```
C: RMG 4 30 C: RMG 4 30
``` ```
Server disconnects client. Server disconnects client.
### With group IDs ### With group IDs
@ -79,7 +78,6 @@ S: 230 7
``` ```
C: RMG 8 30 C: RMG 8 30
``` ```
Server disconnects client. Server disconnects client.
### With group GUIDs ### With group GUIDs
@ -105,9 +103,15 @@ S: 230 11
#### Can not remove out-of-bounds groups #### 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. Server disconnects client.
# Known changes # 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 C: RNG 1
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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). For the command this replaced, read [REA](rea.md).
# Client/Request # 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). 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. 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 * `MFN`: My Friendly Name
* `MOB`: User can contact me via MSN Mobile, changed by the Client Capability. * `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. * `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. * `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 `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 # Server/Response
`SBP TrID contact-id property value` `SBP TrID contact-id property value`
@ -28,25 +32,42 @@ Same parameters as the request.
# Examples # Examples
## Normal use ## Without GUIDs
### Without GUIDs
*Only with `ABCHMigrated: 0`.* *Only with `ABCHMigrated: 0`.*
### My friendly name
``` ```
C: SBP 1 anotheruser@hotmail.com MFN another%20user C: SBP 1 anotheruser@hotmail.com MFN another%20user
S: SBP 1 anotheruser@hotmail.com MFN anoter%20user S: SBP 1 anotheruser@hotmail.com MFN anoter%20user
``` ```
### With GUIDs ## With GUIDs
*Only with `ABCHMigrated: 1`.* *Only with `ABCHMigrated: 1`.*
### My friendly name
``` ```
C: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user C: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
S: 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 ## Errors
None are currently known. If you know of one, please contact me. 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 # Known changes
* [MSNP11](../versions/msnp11.md): Added support for `HSB` property. * [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. * [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 # Introduction
`SDC` is a command introduced with [MSNP5](../versions/msnp5.md). `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. 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). 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 SDC TrID target-address translation-lcid requesting-library client-identification X X my-friendly-name length
payload 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 `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 `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`. 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 C: SDC 7 anotheruser@hotmail.com 10
S: 503 7 S: 503 7
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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. Where `translation-lcid` is the LCID of the translation you'd like the invitation to be in.
Added since [MSNP3](../versions/msnp3.md). 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). Added since [MSNP3](../versions/msnp3.md).
Where `client-identification` is the internal name of the codebase used to create `requesting-library`, usually `MSMSGS`. 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 ## Normal use
### First generation ### E-mail only
*Only in [MSNP2](../versions/msnp2.md).* *Only in [MSNP2](../versions/msnp2.md).*
``` ```
C: SND 1 anotheruser@hotmail.com C: SND 1 anotheruser@hotmail.com
S: SND 1 OK S: SND 1 OK
``` ```
### Second generation ### With language ID and client library name
*Only in [MSNP3](../versions/msnp3.md).* *Only in [MSNP3](../versions/msnp3.md).*
``` ```
C: SND 2 anotheruser@hotmail.com 0x0409 MSMSGS C: SND 2 anotheruser@hotmail.com 0x0409 MSMSGS
S: SND 2 OK S: SND 2 OK
``` ```
### Third generation ### With the client internal name
*Since [MSNP4](../versions/msnp4.md).* *Since [MSNP4](../versions/msnp4.md).*
``` ```
C: SND 3 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS C: SND 3 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS
@ -63,10 +63,9 @@ S: SND 5 OK
C: SND 6 anotheruser@hotmail.com 10 C: SND 6 anotheruser@hotmail.com 10
S: 503 6 S: 503 6
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes
* [MSNP3](../versions/msnp3.md): Added translation support and requesting library parameters. * [MSNP3](../versions/msnp3.md): Added translation support and requesting library parameters.
* [MSNP4](../versions/msnp4.md): Added client codebase parameter. * [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 S: BPR PHH 1%20(222)%20333%204444
``` ```
## Removed ## Command removed
*Since [MSNP13](../versions/msnp13.md).* *Since [MSNP13](../versions/msnp13.md).*
``` ```
C: SYN 16 0 0 C: SYN 16 0 0
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

1
docs/commands/ubx.md
View file

@ -132,7 +132,6 @@ S: UUX anotheruser@hotmail.com 1 202
``` ```
C: UBX 1 0 C: UBX 1 0
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 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).* *Since [MSNP6](../versions/msnp3.md).*
``` ```
C: URL 5 PROFILE 0x0409 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). * `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). * `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). * `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 ### The Subsequent request
`USR TrID security-package S {...response-args}` `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. * `CTP`: Your password in plain text.
* `MD5`: The server's login challenge concatenated with your password. * `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), * `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>`. or if using the [Passport Request Security Token service](../services/rst.md),
* `SSO`: The same as [Passport (SOAP)](../services/passportsoap.md) in `TWN`, but with the extra parameter the `<wsse:BinarySecurityToken>` of the relevant `<wst:RequestSecurityTokenResponse>`.
being the custom challenge response encoded as base64. * `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 ## Switchboard Server
`USR TrID user-handle cookie` `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= 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.* *The key-encryption interlude has been removed from here and is to reinstated as another article.*
``` ```
C: USR 8 SSO S t=ticket HAAAAAEAAAADZgAABIAAAAgAAAAUAAAASAAAAAA C: USR 8 SSO S t=ticket&p=HAAAAAEAAAADZgAABIAAAAgAAAAUAAAASAAAA
.. AAAAAAAAA7XgT5ohvaZdoXdrWUUcMF2G8OK2JohyYcK5l5MJSitab33scxJe .. AAAAAAAAAAA7XgT5ohvaZdoXdrWUUcMF2G8OK2JohyYcK5l5MJSitab33scx
.. K/RQXcUr0L+R2ZA9CEAzn0izmUzSMp2LZdxSbHtnuxCmptgtoScHp9E26HjQ .. JeK/RQXcUr0L+R2ZA9CEAzn0izmUzSMp2LZdxSbHtnuxCmptgtoScHp9E26H
.. VkA9YJxgK/HM= .. jQVkA9YJxgK/HM=
S: USR 8 OK example@hotmail.com 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 C: USR 10 TWN S t=not*a*passport*ticket&p=not*a*profile*either
S: 911 10 S: 911 10
``` ```
Server disconnects client. Server disconnects client.
### Child account not authorized ### Child account not authorized
@ -150,7 +152,6 @@ S: USR 11 MD5 S 1234567890.123456789
C: USR 12 MD5 S f59af8f2fa91d38aff7c870c17f99903 C: USR 12 MD5 S f59af8f2fa91d38aff7c870c17f99903
S: 923 12 S: 923 12
``` ```
Server disconnects client. Server disconnects client.
### Account not verified ### Account not verified
@ -165,7 +166,6 @@ S: USR 13 MD5 S 1234567890.123456789
C: USR 14 MD5 S f59af8f2fa91d38aff7c870c17f99903 C: USR 14 MD5 S f59af8f2fa91d38aff7c870c17f99903
S: 924 14 S: 924 14
``` ```
Server disconnects client. Server disconnects client.
#### Soft warning #### 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 C: USR 18 TWN S t=token&p=profile
S: USR 18 OK example@hotmail.com example%20user 1 1 S: USR 18 OK example@hotmail.com example%20user 1 1
``` ```
Client disconnects from server. Client disconnects from server.
### Wrong server for this account ### Wrong server for this account
@ -195,7 +194,6 @@ Client disconnects from server.
C: USR 19 TWN I example@hotmail.com C: USR 19 TWN I example@hotmail.com
S: 931 19 S: 931 19
``` ```
Server disconnects client. Server disconnects client.
## Switchboard Server ## Switchboard Server

1
docs/commands/uux.md
View file

@ -103,7 +103,6 @@ S: UUX 6
C: UUX 7 19 C: UUX 7 19
<invalid></invalid> <invalid></invalid>
``` ```
Server disconnects client. Server disconnects client.
# Known changes # 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 # Examples
## Unsupported Protocols ## No supported protocols
``` ```
C: VER 1 DISREGARDANCE FOR A REAL PROTOCOL C: VER 1 DISREGARDANCE FOR A REAL PROTOCOL
S: VER 1 0 S: VER 1 0
``` ```
Server disconnects client. Server disconnects client.
## Supported Fallback Protocol ## Supported fallback protocol
``` ```
C: VER 2 MSNP2 CVR0 C: VER 2 MSNP2 CVR0
S: VER 2 CVR0 S: VER 2 CVR0
``` ```
## Supported Primary Protocol ## Supported primary protocol
``` ```
C: VER 3 MSNP8 CVR0 C: VER 3 MSNP8 CVR0
S: VER 3 MSNP8 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 C: XFR 2 NS
S: XFR 2 NS 10.0.0.5:1863 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 ### 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 C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 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 #### Classic
*Only in [MSNP3](../versions/msnp3.md) to [MSNP6](../versions/msnp6.md).* *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 C: USR 4 MD5 I example@hotmail.com
S: XFR 4 NS 10.0.0.5:1863 0 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 #### Modern
*Only in [MSNP7](../versions/msnp7.md) to [MSNP12](../versions/msnp12.md).* *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 C: USR 5 MD5 I example@hotmail.com
S: XFR 5 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 ## After rework
*Since [MSNP13](../versions/msnp13.md).* *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) | | `PROD01065C%ZFN6F` | `O4BG@C7BWLYQX?5G` | Client Version 8.0.0328 (unconfirmed) |
| `PROD0112J1LW7%NB` | `RH96F{PHI8PPX_TJ` | Client Version 8.0.0812 (unconfirmed) | | `PROD0112J1LW7%NB` | `RH96F{PHI8PPX_TJ` | Client Version 8.0.0812 (unconfirmed) |
| `PROD0113H11T8$X_` | `RG@XY*28Q5QHS%Q5` | Client Version 8.1.0168 (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) | | `PROD0118R6%2WYOS` | `YIXPX@5I2P0UT*LK` | Client Version 8.5.1235 (unconfirmed) |
| `PROD0119GSJUC$18` | `ILTXC!4IXB5FB*PX` | Client Version 8.5.1288 (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. * `audio`: Audio Conversations.
* `filexfer`: File transfer. * `filexfer`: File transfer.
* `hotlinks`: Web links. * `hotlinks`: Web links.
If this feature is blocked URLs sent in the chat will not be formatted as links. If this feature is blocked URLs sent in conversation windows will not be formatted as links.
* `ddp`: Dynamic Display Pictures (Flash avatars). * `ddp`: Dynamic Display Pictures (Flash-based profile pictures).
* `winks`: Winks (Flash full chat window animations). * `winks`: Winks (Flash-based full conversation window animations).
### block ### block
*Since [MSNP12](../versions/msnp12.md).* *Since [MSNP12](../versions/msnp12.md).*

14
docs/index.md
View file

@ -4,11 +4,11 @@ Welcome to yellows' MSNP wiki - "we actually have documentation"
Why not visit the [Table of Commands](table_of_commands.md)? Why not visit the [Table of Commands](table_of_commands.md)?
# License # License
Copyright (C) 2024 yellows111. Copyright (C) 2024 yellows111.
Permission is granted to copy, distribute and/or modify this document Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation; or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the article entitled A copy of the license is included in the article entitled
"[GNU Free Documentation License](license.md)". "[GNU Free Documentation License](license.md)".
@ -26,6 +26,7 @@ A copy of the license is included in the article entitled
* [MSNP11](versions/msnp11.md) * [MSNP11](versions/msnp11.md)
* [MSNP12](versions/msnp12.md) * [MSNP12](versions/msnp12.md)
* [MSNP13](versions/msnp13.md) * [MSNP13](versions/msnp13.md)
* [MSNP14](versions/msnp14.md)
More is to come soon! Hopefully! More is to come soon! Hopefully!
@ -34,12 +35,13 @@ More is to come soon! Hopefully!
* [Contact Sharing Service](services/sharingservice.md) * [Contact Sharing Service](services/sharingservice.md)
* [Messenger Config Service](services/msgrconfig.md) * [Messenger Config Service](services/msgrconfig.md)
* [Passport 1.4](services/passport14.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! More is to come soon! Hopefully!
# Other documents and files # Other documents and files
* [Constants used on the wiki](reference_constants.md) * [Constants used on the wiki](reference_constants.md)
* [List of Error Codes and HRESULTs](errors_and_hresults.md)
* [Shields Configuration Data](files/shields.md) * [Shields Configuration Data](files/shields.md)
* [`<NOTIFICATION>` documents](files/notification.md) * [`<NOTIFICATION>` documents](files/notification.md)
* [Challenge key pairs](files/challenge_keypairs.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. * [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? * [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)? * [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. * [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: 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. * 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. * `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. * Protocol Split: A MSNP version that usually defines a point of no return.
* PP14: [Passport SSI Version 1.4](services/passport14.md). * 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. * 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. * 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. * 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`. An example of the Private Key is `Q1P7W2E4J9R8U3S5` or `YMM8C_H7KCQ2S_KL`.
# Where can I find or edit the source of the articles provided? # 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, 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). 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 # Introduction
The Address Book Service (abservice) is a SOAP (XML) Web Service. The Address Book Service (abservice), also known as the Address Book Clearing House (ABCH) is a SOAP (XML) Web Service.
Introduced with [MSNP8](../versions/msnp8.md). 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). 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: * `<contactType>`: The type of contact this is related to:
* `LivePending`: A user yet to authorise you * `LivePending`: A user yet to authorise you
* `Regular`: A user from another service. * `Regular`: A user from another service.
* `Me`: My own user.
* `<displayName>`: The display name for this contact. * `<displayName>`: The display name for this contact.
* `<puid>`: Unused. Always 0. * `<puid>`: Unused. Always 0.
* `<CID>`: The Common ID of this contact, which is a signed 64-bit integer. * `<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, Passport 1.4, or "Tweener", as it's sometimes called,
is an HTTP-based authentication system that was introduced with [MSNP8](../versions/msnp8.md). 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 # Nexus
The Passport Nexus is a server that provides information to other parties about how to use Passport. The Passport Nexus is a server that provides information to other parties about how to use Passport.

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

@ -1,10 +1,11 @@
# Introduction # 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). 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 [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 # Client/Request
The following sub-headers are XML elements for the client's 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 # Introduction
The Contact Sharing Service (SharingService) is a SOAP (XML) Web Service. 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 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 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`. 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). 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 # Table of Commands
This is a list of all known MSNP commands and their originating version. 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) | | `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 | | [`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) | | [`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) | | [`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.) | | [`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) | | [`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) | | [`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) | | | [`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) | | [`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) | | [`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.) | | [`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.) | | [`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) | | [`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) (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) | | [`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)) | | [`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) | | | [`SDC`](commands/sdc.md) | Y | Y | N | [MSNP5](versions/msnp5.md) | |

4
docs/versions/cvr0.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
CVR0 is a subprotocol of the Mobile Status Notification Protocol. CVR0 is a subprotocol of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 1.0.0863, along with [MSNP2](msnp2.md). It was introduced officially in Client Version 1.0.0863, along with [MSNP2](msnp2.md).
It is used for requesting the latest client information in case no other protocols were supported. It is used for requesting the latest client information in case no other protocols were supported.
@ -8,8 +8,6 @@ It is used for requesting the latest client information in case no other protoco
It introduces the commands: It introduces the commands:
* [CVQ](../commands/cvq.md) * [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* *No commands were known to be removed in this version*
# Known changes # Known changes

19
docs/versions/msnp10.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP10 is the ninth released version of the Mobile Status Notification Protocol. MSNP10 is the ninth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 6.1.0155. It was introduced officially in Client Version 6.1.0155.
# Command information # Command information
@ -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 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: The following commands were removed in this version:
* [ADD](../commands/add.md) (automatic disconnection) * [ADD](../commands/add.md) (automatic disconnection)
* [REA](../commands/rea.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. 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, * 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. 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)). * First protocol version to remove a core command implemented since [MSNP2](msnp2.md) draft ([ADD](../commands/add.md)).
# Client-server communication example # 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNP10 MSNP9 CVR0
S: VER 4 MSNP10 S: VER 4 MSNP10
@ -122,9 +117,9 @@ C: CHG 9 NLN
S: CHG 9 NLN S: CHG 9 NLN
S: OUT MIG 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 C: VER 10 MSNP10 MSNP9 CVR0
S: VER 10 MSNP10 S: VER 10 MSNP10
@ -174,8 +169,8 @@ C: CHG 15 NLN
S: CHG 15 NLN S: CHG 15 NLN
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

21
docs/versions/msnp11.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP11 is the tenth released version of the Mobile Status Notification Protocol. MSNP11 is the tenth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 7.0.0777. It was introduced officially in Client Version 7.0.0777.
# Command information # Command information
@ -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 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* *No commands were known to be removed in this version*
# Known changes # Known changes
@ -39,14 +37,13 @@ It introduces the notification service commands:
[`<NotificationData>`](../files/notification.md) sub-documents are supported for spaces (blogs). [`<NotificationData>`](../files/notification.md) sub-documents are supported for spaces (blogs).
* Official Client: Messenger Config requests now support regional arguments via SOAP. * Official Client: Messenger Config requests now support regional arguments via SOAP.
* Official Client: [OUT](../commands/out.md) SSD is actually implemented now. * 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 # Client-server communication example
*NOTE: This has been line-breaked. *NOTE: This has been line-breaked.
Lines beginning with `..` followed by a space are continuations of the previous line.* Lines beginning with `..` followed by a space are continuations of the previous line.*
``` ```
C: VER 1 MSNP10 MSNP9 CVR0 C: VER 1 MSNP11 MSNP10 MSNP9 CVR0
S: VER 1 MSNP10 S: VER 1 MSNP11
C: CVR 2 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com 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 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 .. 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNP11 MSNP10 MSNP9 CVR0
S: VER 4 MSNP10 S: VER 4 MSNP11
C: CVR 5 0x0409 winnt 5.1 i386 MSNMSGR 6.0.0602 MSMSGS example@hotmail.com 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 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 .. http://download.microsoft.com/download/8/3/C/83C4B2DB-AC1C-4B56-8144-4472C0982F21/SetupDl.exe
@ -152,8 +149,8 @@ S: NOT 1264
</NOTIFICATION> </NOTIFICATION>
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

23
docs/versions/msnp12.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP12 is the eleventh released version of the Mobile Status Notification Protocol. MSNP12 is the eleventh released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 7.5.0299. It was introduced officially in Client Version 7.5.0299.
# Command information # Command information
@ -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 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* *No commands were known to be removed in this version*
# Known changes # 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. * 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 * 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. [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)). * [LST](../commands/lst.md) has the Network ID after the list bits (on any list),
* Official Client: Uses Passport 3.0 (via the Microsoft Identity Common Runtime Library). 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: 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: 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 * 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNP12 MSNP11 MSNP10 CVR0
S: VER 4 MSNP12 S: VER 4 MSNP12
@ -49,10 +49,11 @@ S: CVR 5 6.1.0211 6.1.0211 6.1.0155
.. http://messenger.msn.com .. http://messenger.msn.com
C: USR 6 TWN I example@hotmail.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: 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: USR 7 OK example@hotmail.com 1 0
S: SBS 0 null S: SBS 0 null
S: MSG Hotmail Hotmail 465 S: MSG Hotmail Hotmail 465
@ -99,8 +100,8 @@ C: UUX 11 53
S: UUX 11 0 S: UUX 11 0
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

15
docs/versions/msnp13.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP13 is the twelfth released version of the Mobile Status Notification Protocol. MSNP13 is the twelfth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 8.0.0787, along with [MSNP14](msnp14.md). It was introduced officially in Client Version 8.0.0787, along with [MSNP14](msnp14.md).
# Command information # Command information
@ -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 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: The following commands were removed in this version:
* [ADC](../commands/adc.md) (automatic disconnection) * [ADC](../commands/adc.md) (automatic disconnection)
* [ADG](../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) 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`. have been replaced with two new parameters, one containing `U`, and one containing a `D`.
The use of these parameters is unknown. 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, will now include a request for few more security tokens,
notably `contacts.msn.com` for the [Address Book Service](../services/abservice.md). notably `contacts.msn.com` for the [Address Book Service](../services/abservice.md).
* Replaced [SYN](../commands/syn.md) with both the * 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 U D 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 C: VER 4 MSNP13 CVR0
S: VER 4 MSNP13 S: VER 4 MSNP13
@ -102,7 +100,8 @@ S: CVR 5 8.0.0566 8.0.0566 8.0.0566
.. http://ideas.live.com .. http://ideas.live.com
C: USR 6 TWN I example@hotmail.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: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
S: GCF 0 201 S: GCF 0 201
@ -117,7 +116,7 @@ S: GCF 0 201
</config> </config>
</Policy> </Policy>
</Policies> </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: USR 7 OK example@hotmail.com 1 0
S: SBS 0 null S: SBS 0 null
S: MSG Hotmail Hotmail 481 S: MSG Hotmail Hotmail 481

20
docs/versions/msnp14.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP14 is the thirteenth released version of the Mobile Status Notification Protocol. MSNP14 is the thirteenth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 8.0.0787, along with [MSNP13](../versions/msnp13.md). It was introduced officially in Client Version 8.0.0787, along with [MSNP13](../versions/msnp13.md).
# Command information # Command information
@ -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 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* *No commands were known to be removed in this version*
# Known changes # 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 * [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. 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) * [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. * 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. 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 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, 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:`. 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. 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 # Client-server communication example
*NOTE: This has been line-breaked. *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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 U D 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 C: VER 4 MSNP14 MSNP13 CVR0
S: VER 4 MSNP14 S: VER 4 MSNP14
@ -58,7 +57,8 @@ S: CVR 5 8.0.0566 8.0.0566 8.0.0566
.. http://ideas.live.com .. http://ideas.live.com
C: USR 6 TWN I example@hotmail.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: USR 6 TWN S passport=parameters,neat=huh,lc=1033,id=507
S: GCF 0 201 S: GCF 0 201
@ -73,7 +73,7 @@ S: GCF 0 201
</config> </config>
</Policy> </Policy>
</Policies> </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: USR 7 OK example@hotmail.com 1 0
S: SBS 0 null S: SBS 0 null
S: MSG Hotmail Hotmail 465 S: MSG Hotmail Hotmail 465

57
docs/versions/msnp2.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP2 is the first released version of the Mobile Status Notification Protocol. MSNP2 is the first released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 1.0.0863, along with [CVR0](cvr0.md). It was introduced officially in Client Version 1.0.0863, along with [CVR0](cvr0.md).
# Command information # Command information
@ -26,7 +26,7 @@ It introduces the notification service commands:
* [OUT](../commands/out.md) * [OUT](../commands/out.md)
* [PNG](../commands/png.md) (not in draft) * [PNG](../commands/png.md) (not in draft)
* [QNG](../commands/qng.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) * [REM](../commands/rem.md)
* [RNG](../commands/rng.md) * [RNG](../commands/rng.md)
* [SND](../commands/snd.md) (not in draft) * [SND](../commands/snd.md) (not in draft)
@ -48,51 +48,6 @@ It introduces the switchboard service commands:
* [OUT](../commands/out.md) * [OUT](../commands/out.md)
* [USR](../commands/usr.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* *No commands were known to be removed in this version*
# Known changes # Known changes
@ -108,9 +63,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 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 C: VER 4 MSNP2 CVR0
S: VER 4 MSNP2 S: VER 4 MSNP2
@ -147,8 +102,8 @@ S: REA 13 5 example@hotmail.com example%20user
S: FLN anotheruser@hotmail.com S: FLN anotheruser@hotmail.com
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

44
docs/versions/msnp3.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP3 is the second released version of the Mobile Status Notification Protocol. MSNP3 is the second released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 2.0.0085. It was introduced officially in Client Version 2.0.0085.
# Command information # Command information
@ -8,14 +8,6 @@ It introduces the notification service commands:
*No switchboard or dispatch commands were known to be introduced in this version* *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* *No commands were known to be removed in this version*
# Known changes # Known changes
@ -53,32 +45,6 @@ It introduces the error codes:
* Official Client: Removed [URL](../commands/url.md) service `PASSWORD`. * Official Client: Removed [URL](../commands/url.md) service `PASSWORD`.
* Official Client: Disabled inviting people to the service (needs confirmation). * 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 # Client-server communication example
``` ```
C: VER 1 MSNP3 MSNP2 CVR0 C: VER 1 MSNP3 MSNP2 CVR0
@ -88,9 +54,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 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 C: VER 4 MSNP3 MSNP2 CVR0
S: VER 4 MSNP3 S: VER 4 MSNP3
@ -134,8 +100,8 @@ C: SND 12 anotheruser@hotmail.com 0x0409 MSMSGS
S: SND 12 OK S: SND 12 OK
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

24
docs/versions/msnp4.md
View file

@ -1,12 +1,10 @@
# Introduction # Introduction
MSNP4 is the third released version of the Mobile Status Notification Protocol. MSNP4 is the third released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 2.1.1047. It was introduced officially in Client Version 2.1.1047.
# Command information # Command information
*No commands for any service were known to be introduced in this version* *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* *No commands were known to be removed in this version*
# Known changes # 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 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. "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 # Client-server communication example
``` ```
C: VER 1 MSNP4 MSNP3 CVR0 C: VER 1 MSNP4 MSNP3 CVR0
@ -40,9 +26,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 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 C: VER 4 MSNP4 MSNP3 CVR0
S: VER 4 MSNP4 S: VER 4 MSNP4
@ -82,8 +68,8 @@ C: SND 10 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS
S: SND 10 OK S: SND 10 OK
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

34
docs/versions/msnp5.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP5 is the fourth released version of the Mobile Status Notification Protocol. MSNP5 is the fourth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 3.0.0283. It was introduced officially in Client Version 3.0.0283.
# Command information # Command information
@ -12,9 +12,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version* *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* *No commands were known to be removed in this version*
# Known changes # Known changes
@ -38,27 +35,6 @@ It introduces the error codes:
which when sent as a [USR](../commands/usr.md) response, shows the 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. "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 # Client-server communication example
``` ```
C: VER 1 MSNP5 MSNP4 CVR0 C: VER 1 MSNP5 MSNP4 CVR0
@ -68,9 +44,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 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 C: VER 4 MSNP5 MSNP4 CVR0
S: VER 4 MSNP5 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 S: BPR 8 anotheruser@hotmail.com PHH 1%20(222)%20333%204444
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

28
docs/versions/msnp6.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP6 is the fifth released version of the Mobile Status Notification Protocol. MSNP6 is the fifth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 3.6.0038. It was introduced officially in Client Version 3.6.0038.
# Command information # Command information
@ -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 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*
It introduces the error codes:
* 540
* 915
* 916
# Known changes # Known changes
(from [MSNP5](msnp5.md)): (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: 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. * 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 # Client-server communication example
``` ```
C: VER 1 MSNP6 MSNP5 MSNP4 CVR0 C: VER 1 MSNP6 MSNP5 MSNP4 CVR0
@ -51,9 +35,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 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 C: VER 4 MSNP6 MSNP5 MSNP4 CVR0
S: VER 4 MSNP6 S: VER 4 MSNP6
@ -110,8 +94,8 @@ S: IPG 478
</NOTIFICATION> </NOTIFICATION>
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

45
docs/versions/msnp7.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP7 is the sixth released version of the Mobile Status Notification Protocol. MSNP7 is the sixth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 4.5.0121. It was introduced officially in Client Version 4.5.0121.
# Command information # Command information
@ -11,17 +11,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version* *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* *No commands were known to be removed in this version*
# Known changes # Known changes
@ -41,30 +30,6 @@ It introduces the error codes:
* Official Client: Added new [URL](../commands/url.md) service `CHAT`. * Official Client: Added new [URL](../commands/url.md) service `CHAT`.
* Official Client: Removed [URL](../commands/url.md) services `N2PACCOUNT` and `N2PFUND`. * 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 # Client-server communication example
``` ```
C: VER 1 MSNP7 MSNP6 MSNP5 MSNP4 CVR0 C: VER 1 MSNP7 MSNP6 MSNP5 MSNP4 CVR0
@ -74,9 +39,9 @@ S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNP7 MSNP6 MSNP5 MSNP4 CVR0
S: VER 4 MSNP7 S: VER 4 MSNP7
@ -142,8 +107,8 @@ C: RMG 14 2
S: RMG 14 14 2 S: RMG 14 14 2
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

20
docs/versions/msnp8.md
View file

@ -1,12 +1,10 @@
# Introduction # Introduction
MSNP8 is the seventh released version of the Mobile Status Notification Protocol. MSNP8 is the seventh released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 5.0.0537. It was introduced officially in Client Version 5.0.0537.
# Command information # Command information
*No commands for any service were known to be introduced in this version* *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: The following commands were removed in this version:
* [INF](../commands/inf.md) (automatic disconnection) * [INF](../commands/inf.md) (automatic disconnection)
* [FND](../commands/fnd.md) (`502` by July 2003, see Known changes for client details.) * [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. You can now tell other clients what features you support.
* Official Client: Connectivity field added to application requests * Official Client: Connectivity field added to application requests
to notify the other user about what the network conditions are. 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`. The URL is gathered from `svcs.microsoft.com`.
`abch_config.asp` provides an XML document with a `<abchconfig>` element. `abch_config.asp` provides an XML document with a `<abchconfig>` element.
It has a `<url>` element containing the service URL, a `<refresh>` 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. `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` * 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 # Client-server communication example
*NOTE: This has been line-breaked. *NOTE: This has been line-breaked.
Lines beginning with `..` followed by a space are continuations of the previous line.* 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNP8 CVR0
S: VER 4 MSNP8 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 S: NLN NLN anotheruser@hotmail.com another%20user 28
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

15
docs/versions/msnp9.md
View file

@ -1,5 +1,5 @@
# Introduction # Introduction
MSNP9 is the eighth released version of the Mobile Status Notification Protocol. MSNP9 is the eighth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version 6.0.0312. It was introduced officially in Client Version 6.0.0312.
# Command information # Command information
@ -8,9 +8,6 @@ It introduces the notification service commands:
*No switchboard or dispatch service commands were known to be introduced in this version* *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: The following commands were removed in this version:
* [PAG](../commands/pag.md) (returns 715) * [PAG](../commands/pag.md) (returns 715)
* [LST](../commands/lst.md) (Only client-initated, the one in [SYN](../commands/syn.md) is kept, * [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. * 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. 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. * [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`. * Official Client: Supports the [Messenger Config](../services/msgrconfig.md) XML service, replacing `svcs.microsoft.com`.
# Client-server communication example # 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNP9 MSNP8 CVR0
S: VER 4 MSNP9 S: VER 4 MSNP9
@ -114,8 +109,8 @@ S: NOT 457
</NOTIFICATION> </NOTIFICATION>
C: OUT C: OUT
``` ```
Client disconnects from server Client disconnects from server.
``` ```
S: OUT S: OUT
``` ```
Server disconnects client Server disconnects client.

6
package-lock.json generated
View file

@ -1,15 +1,15 @@
{ {
"name": "yellows-msnp-wiki", "name": "yellows-msnp-wiki",
"version": "0.1.4", "version": "0.2.0",
"lockfileVersion": 3, "lockfileVersion": 3,
"requires": true, "requires": true,
"packages": { "packages": {
"": { "": {
"name": "yellows-msnp-wiki", "name": "yellows-msnp-wiki",
"version": "0.1.4", "version": "0.2.0",
"license": "GFDL-1.3-or-later", "license": "GFDL-1.3-or-later",
"dependencies": { "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": { "node_modules/@liquify/prettify": {

2
package.json
View file

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

3
templates/command.md
View file

@ -33,13 +33,12 @@ S: xxx 3
## Invalid argument ## Invalid argument
*NOTE: This is an assumption. The actual error code here is unknown. *NOTE: This is an assumption. The actual error code here is unknown.
It may also lead to an Instant Disconnection.* It may also lead to an Instant Disconnection.*
*NOTE: There is no defined behavour for this command specifically.* *NOTE: There is no defined behavour for this command specifically.*
``` ```
C: xxx 4 something wrong to go here C: xxx 4 something wrong to go here
S: 201 S: 201
``` ```
Server disconnects client. Server disconnects client.
# Known changes # Known changes

12
templates/msnpver.md
View file

@ -1,14 +1,10 @@
# Introduction # Introduction
MSNPx is the nth released version of the Mobile Status Notification Protocol.
MSNPx is the nth released version of the Mobile Status Notification Protocol.
It was introduced officially in Client Version y.y.yyyy. It was introduced officially in Client Version y.y.yyyy.
# Command information # Command information
*No commands for any service were known to be introduced in this version* *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* *No commands were known to be removed in this version*
# Known changes # 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 C: USR 3 TWN I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0 10.0.0.1:1863 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 C: VER 4 MSNPx MSNPx-1 CVR0
S: VER 4 MSNPx S: VER 4 MSNPx