2.5 KiB

Raw Blame History

Introduction

ADD is a command introduced with MSNP2.

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

Adds a user to a list. Replaced by ADL in MSNP10.

Client/Request

ADD TrID [ FL | AL | BL ] user-handle custom-friendly-name {group}

Where user-handle is the relevant user's handle.

Where custom-friendly-name is the friendly name of this user you'd like to store in this list.

Where group is the group to add the user to. Only applies for Forward List (FL). Since MSNP7.

Server/Response

ADD TrID [ FL | AL | BL | RL ] list-version user-handle custom-friendly-name {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.

Examples

Normal use

Without groups

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

With groups

Since MSNP7.

C: ADD 3 FL anotheruser@hotmail.com anotheruser@hotmail.com 0
S: ADD 3 FL 256 anotheruser@hotmail.com anotheruser@hotmail.com 0
C: ADD 4 AL anotheruser@hotmail anotheruser@hotmail.com
S: ADD 4 AL 257 anotheruser@hotmail.com anotheruser@hotmail.com

Invalid handle

C: ADD 5 FL a@b a@b
S: 201 5

Account not found

C: ADD 6 FL ghost@hotmail.com ghost@hotmail.com
S: 205 7

Target list is full

C: ADD 8 FL stuffed@hotmail.com stuffed@hotmail.com
S: 210 8

User already in that list

C: ADD 9 FL anotheruser@hotmail.com anotheruser@hotmail.com
S: 215 9

User can not be in both lists

C: ADD 10 BL anotheruser@hotmail.com anotheruser@hotmail.com
S: 219 10

Group doesn't exist