msnp-wiki/docs/commands/prp.md
yellows111 ce7c3bee1c
0.2.0: The Winter Roll-up
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
2024-12-18 20:16:29 +00:00

2 KiB

Introduction

PRP is a command introduced with MSNP5.

It is a Notification Server command, without either a request or response payload.

It sets or gets (during SYN) a personal user property. Other users are handled via BPR.

Client/Request

PRP TrID property value

Where property can be any of these values:

  • PHH: Home Phone number. Has a maximum of 95 bytes.
  • PHW: Work Phone number. Has a maximum of 95 bytes.
  • PHM: Mobile Phone number. Has a maximum of 95 bytes.
  • MOB: Allow users to contact me via MSN Mobile.
  • MFN: [MSNP10+] My Friendly Name, Has a maximum of 387 bytes.

The data of the property parameter cannot be longer than 3 bytes.

Where value is the URL-encoded value to set the related property to.

Server/Response

PRP TrID {list-version} property value

Where list-version is the new List Version. Removed since MSNP10 in ABCHMigrated: 1 mode.

The following property values are only set by the server:

  • MBE: MSN Mobile enabled.
  • WWE: [MSNP9+] MSN Direct / Web Watch enabled.
  • HSB: [MSNP11+] Has Blog (MSN Space).

Examples

Setting PHH

C: PRP 1 PHH 1%20(222)%203333
S: PRP 1 256 PHH 1%20(222)%203333

Unknown property

C: PRP 2 NEW very%20yes
S: 715 2

Property key is too long

C: PRP 3 NICE Y

Server disconnects client.

Property value is too long

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line.

C: PRP 4 PHM this%20is%20way%20too%20long%20of%20a
.. %20phone%20number%20not%20like%20it%20is%20one%20anyway...

Server disconnects client.

Known changes

  • MSNP8: During SYN, the current List Version is omitted.
  • MSNP10: Added MFN property, "My Friendly Name", List Version removed from response in ABCHMigrated: 1 mode.