msnp-wiki/docs/commands/prp.md

50 lines
1.5 KiB
Markdown

# Introduction
`PRP` is a command introduced with [MSNP5](../versions/msnp5.md).
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](bpr.md).
# Client/Request
`PRP TrID property value`
Where `property` can be any of these values:
* `PHH`: Home Phone number
* `PHW`: Work Phone number
* `PHM`: Mobile Phone number
* `MOB`: Allow users to contact me via MSN Mobile
* `MFN`: [[MSNP10](../versions/msnp10.md)+] My Friendly Name
Where `value` is the 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](../versions/msnp10.md) in `ABCHMigrated: 1` mode.
The following `property` values are only set by the server:
* `MBE`: MSN Mobile enabled
* `WWE`: [[MSNP9](../versions/msnp9.md)+] MSN Direct / Web Watch enabled
* `HSB`: [[MSNP11](../versions/msnp11.md)+] 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
*NOTE: There is no defined behavour for this command specifically.*
```
C: PRP 2 NEW very%20yes
```
Server disconnects client.
# Known changes
* [MSNP8](../versions/msnp8.md): During SYN, the current List Version is omitted.
* [MSNP10](../versions/msnp10.md): Added `MFN` property, "My Friendly Name",
List Version removed from response in `ABCHMigrated: 1` mode.