yellows111
/
msnp-wiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
msnp-wiki/docs/commands/rem.md

3.8 KiB
Raw Blame History

Introduction

REM is a command introduced with MSNP2.

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

It removes a user from a list.

Client/Request

REM TrID [ FL | AL | BL | PL ] [ user-handle | contact-guid ] {group}

The Pending List (PL) is only avaliable since MSNP10.

Where user-handle is the user's handle to remove from the list.

If using MSNP10, if the list to remove from is the Forward List (FL), user-handle is replaced with contact-guid, which is the contact's GUID.

If group is specified and the list is set to the Forward List (FL), then the user is only removed from the specified group. To remove a user from a list entirely, omit the group parameter.

Server/Response

REM TrID [ FL | AL | BL | RL | PL ] {list-version} {group}

If this is an asynchronous use of this command, the Transaction ID (or TrID) will be set to 0.

Where list-version is the new List Version. Removed since MSNP10.

Examples

With List Versions

Only in MSNP2 to MSNP9.

Remove from any modifiable list using a user handle

C: REM 1 AL anotheruser@hotmail.com
S: REM 1 AL 256 anotheruser@hotmail.com
C: REM 2 FL anotheruser@hotmail.com
S: REM 2 FL 257 anotheruser@hotmail.com

Remove from group

Since MSNP7. NOTE: Only applies to FL.

C: REM 3 FL anotheruser@hotmail.com 1
S: REM 3 FL 258 anotheruser@hotmail.com 1

Without List Versions

Since MSNP10.

Remove from Forward List entirely using a GUID

NOTE: Only applies to FL.

C: REM 4 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98
S: REM 4 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98

Remove from other lists using a user handle

C: REM 5 AL anotheruser@hotmail.com
S: REM 5 AL anotheruser@hotmail.com

Remove from group using two GUIDs

NOTE: Only applies to FL.

C: REM 6 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98 d6deeacd-7849-4de4-93c5-d130915d0042
S: REM 6 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98 d6deeacd-7849-4de4-93c5-d130915d0042

User not in that list

C: REM 7 BL ghost@hotmail.com
S: 216 7

Group does not exist

Before GUIDs

Only in MSNP7 to MSNP9. NOTE: Only applies to FL.

C: REM 8 FL anotheruser@hotmail.com 32
S: 224 8

After GUIDS

Since MSNP10. NOTE: Only applies to FL.

C: REM 9 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98 00000000-0000-0000-0000-000000000000
S: 224 9

Group exists, but user is not in it

Before GUIDs

Only in MSNP7 to MSNP9. NOTE: Only applies to FL.

C: REM 10 FL anotheruser@hotmail.com 1
S: 225 10

After GUIDS

Since MSNP10. NOTE: Only applies to FL.

C: REM 11 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98 f0a0df8f-22a4-452c-9e3c-6252420480e9
S: 225 11

You can not modify the Reverse List

C: REM 12 RL anotheruser@hotmail.com

Server disconnects client.

Asynchronous update

With List Version parameter

Only in MSNP2 to MSNP9.

S: REM 0 RL 259 anotheruser@hotmail.com
S: REM 0 FL 260 anotheruser@hotmail.com

Without List Version parameter

Since MSNP10.

S: REM 0 RL anotheruser@hotmail.com
S: REM 0 FL c1f9a363-4ee9-4a33-a434-b056a4c55b98

Known changes

  • MSNP7: Added groups support.
  • MSNP10: Added GUID support, replacing the user's handle for FL requests and removed updating the List Version.
  • MSNP13: Removed (automatic disconnect), replaced with RML.