Protocols/MSNP/Commands/REA

REA

SUMMARY

Renames a principal in one's contact list.

SYNTAX

   REA trid email display-name

• display-name: The desired URLencoded new display name of the principal.

RESPONSE

   REA trid ver-num email display-name

DESCRIPTION

The specified principal is renamed. There is a restriction of 387 bytes on the name, after URL-encoding is applied. Renaming oneself is allowed and the only way to set one's own display name.

ERRORS

• 209: Blocked display name
• 216: Principal not in list
• 800: Command issued too rapidly

VERSION

MSNP8, MSNP9

REA (MSNP11)

MSNP11 (and up?): This command was dropped and replaced by PRP.

The REA command is used to change your displayed name to something else.

REA trid your_email newname\r\n

• trid : Transaction ID
• your_email : The email you use to sign on to MSN.
• newname : The name that you now wish to use in a Protocols/MSNP/URL Encoded format.

If the rename has been successful, the server will respond with the following.

REA trid number your_email newname\r\n

• trid : Transaction ID
• number : Purpose currently unknown.
• your_email : The email you use to sign on to MSN.
• newname : The name that you wished to use in plain text.