# Table of contents:
- Introduction
- Client/Request
- Server/Response
- Examples
- Known changes
# 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
# 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
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, use RML and the
Address Book Service's
ABContactDelete
action or the Contact Sharing Service'sDeleteMember
action instead.