Protocols/MSNP/Commands/REM

From NINA Wiki
Revision as of 12:46, 1 August 2009 by AD (talk | contribs) (add missing MSNP8/9 info)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

REM

SUMMARY

Removes a principal from a group or list.

SYNTAX

   REM trid list email [group]
  • list: one of "AL", "BL", "FL".

RESPONSE

   REM trid list ver-num email [group]
  • ver-num: Was used to support revision numbers of the contacts list, but now 1 since the feature was dropped.

DESCRIPTION

The specified principal is removed from the group or list. If no group number is specified for removal from FL, the principal is removed from all groups.

ERRORS

  • 216: Principal not in list
  • 224: Nonexistent group
  • 225: Principal not in group

Attempting to remove principals from one's RL will cause disconnection.

VERSION

MSNP8, MSNP9. See below for MSNP11 and above syntax.

REM (MSNP11)

Remove a contact from any of your lists. Some care has to be taken using this command. Adding someone to your FL uses the GUID of a contact instead of his email, and accepts group parameters (comma-delimited GUID's).

-- MSNP11 (and others?) behaviour --

You cannot remove somebody from your RL. Since you can add anyone to your RL this allows you to fill your RL up, keep in mind that only the users in your RL can remove themselves from your RL (by removing you from their FL). REM from RL results in d/c.

FL:

<<< REM 61 FL xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
>>> REM 61 FL xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

AL BL PL:

<<< REM 61 AL name@hotmail.com
>>> REM 61 AL name@hotmail.com

RL:

<<< REM 61 RL name@hotmail.com
** disconnected...

See also: Protocols/MSNP/MSNP11/Changes#Reverse List Additions