msnp-wiki/docs/commands/rea.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.1 KiB

Introduction

REA is a command introduced with MSNP2.

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 and SBP.

Client/Request

REA TrID user-handle new-friendly-name

Where user-handle is the user handle that you'd like to change the friendly name of. If this is the current user's handle, the change will be announced via NLN 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, which may be rejected for any reason by the server.

Server/Response

REA TrID list-version user-handle new-friendly-name

Where list-version is the new List Version.

Examples

Changing my friendly name

C: REA 1 example@hotmail.com new%20name
S: REA 1 256 example@hotmail.com new%20name

Changing a stored friendly name

S: NLN NLN anotheruser@hotmail.com different%20name
C: REA 2 anotheruser@hotmail.com different%20name
S: REA 2 257 anotheruser@hotmail.com different%20name

You are not allowed to have that name

C: REA 3 example@hotmail.com bad
S: 209 3

You can not change the friendly name of a user that is not on any of your Lists

C: REA 4 ghost@hotmail.com ghost
S: 216 4

You have been rate limited, try again later

C: REA 5 example@hotmail.com new%20name%201
S: REA 5 258 example@hotmail.com new%20name%201
C: REA 6 example@hotmail.com new%20name%202
S: REA 6 258 example@hotmail.com new%20name%202
C: REA 7 example@hotmail.com new%20name%203
S: REA 7 258 example@hotmail.com new%20name%203
C: REA 8 example@hotmail.com new%20name%204
S: REA 8 258 example@hotmail.com new%20name%204
C: REA 9 example@hotmail.com new%20name%205
S: REA 9 258 example@hotmail.com new%20name%205
C: REA 10 example@hotmail.com new%20name%206
S: 800 10

Known changes

  • MSNP10: Removed (automatic disconnection?). Use PRP MFN to change your own friendly name, and SBP MFN to change stored friendly names.