yellows111
9144709921
apparently 923 and 924 are supported way earlier it's REALLY confusing apparently because yes those clients DO handle those codes, but HOW? makes me want to throw out the error code tables because it seems like different clients implement them in different ways with no established rule, especially those two because only 924 doesn't appear in plain text in the main binary until P7, but it absolutely exists before then? And for 923... I don't even know. It's not in the main binary (at all). Let alone in later versions.
104 lines
2.5 KiB
Markdown
104 lines
2.5 KiB
Markdown
# Introduction
|
|
`ADD` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
It is a Notification Server command, without a request or response payload.
|
|
|
|
Adds a user to a list. Replaced by [ADC](adc.md) in [MSNP10](../versions/msnp10.md).
|
|
|
|
# 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](../versions/msnp7.md).
|
|
|
|
# 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](../versions/msnp7.md).*
|
|
```
|
|
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 6
|
|
```
|
|
|
|
## Target list is full
|
|
```
|
|
C: ADD 7 FL stuffed@hotmail.com stuffed@hotmail.com
|
|
S: 210 7
|
|
```
|
|
|
|
## User already in that list
|
|
```
|
|
C: ADD 8 FL anotheruser@hotmail.com anotheruser@hotmail.com
|
|
S: 215 8
|
|
```
|
|
|
|
## User can not be in both lists
|
|
```
|
|
C: ADD 9 BL anotheruser@hotmail.com anotheruser@hotmail.com
|
|
S: 219 9
|
|
```
|
|
|
|
## Group doesn't exist
|
|
*Since [MSNP7](../versions/msnp7.md).*
|
|
```
|
|
C: ADD 10 FL anotheruser@hotmail.com anotheruser@hotmail.com 31
|
|
S: 224 10
|
|
```
|
|
|
|
## You can not modify the Reverse List
|
|
```
|
|
C: ADD 11 RL anotheruser@hotmail.com anotheruser@hotmail.com
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
## Removed
|
|
```
|
|
C: ADD 12 FL anotheruser@hotmail.com anotheruser@hotmail.com
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
## Asynchronous update
|
|
```
|
|
S: ADD 0 RL 258 anotheruser@hotmail.com anotheruser@hotmail.com
|
|
```
|
|
|
|
# Known changes
|
|
* [MSNP7](../versions/msnp7.md): Now supports groups if target list is Forward List.
|
|
* [MSNP10](../versions/msnp10.md): Removed (automatic disconnect). Use [ADC](adc.md) instead.
|