116 lines
2.4 KiB
Markdown
116 lines
2.4 KiB
Markdown
# Introduction
|
|
`RMG` is a command introduced with [MSNP7](../versions/msnp7.md).
|
|
|
|
It is a Notification Server command, without either a request or response payload.
|
|
|
|
Removes all users from a group and the group itself.
|
|
Replaced with [Address Book Service](../services/abservice.md)'s `ABGroupDelete` in [MSNP13](../versions/msnp13.md).
|
|
|
|
# Client/Request
|
|
`RMG TrID group-id`
|
|
|
|
Where `group-id` is the identification number of the group you would like to remove.
|
|
With `ABCHMigrated: 1`, this parameter is instead the GUID of the group you'd like to remove.
|
|
You cannot remove the "Other Contacts" group (group ID `0`).
|
|
|
|
*NOTE: If users are exclusively in the group you remove,
|
|
THEY WILL BE ALSO REMOVED FROM THE FORWARD LIST (FL).*
|
|
|
|
# Server/Response
|
|
`RMG TrID {list-version} group-id`
|
|
|
|
Where `list-version` is the new List Version. Removed in [MSNP10](../versions/msnp10.md).
|
|
|
|
# Examples
|
|
|
|
## With List Versions
|
|
*Only in [MSNP7](../versions/msnp7.md) to [MSNP9](../versions/msnp9.md).*
|
|
|
|
## Without List Versions
|
|
|
|
### Normal use
|
|
```
|
|
C: RMG 1 1
|
|
S: RMG 1 256 1
|
|
```
|
|
|
|
### Group doesn't exist yet
|
|
```
|
|
C: RMG 2 2
|
|
S: 224 2
|
|
```
|
|
|
|
### Can not remove the initial group
|
|
```
|
|
C: RMG 3 0
|
|
S: 230 3
|
|
```
|
|
|
|
### Can not remove out-of-bounds groups
|
|
```
|
|
C: RMG 4 30
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
### With group IDs
|
|
*Only in [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 0`.*
|
|
|
|
#### Normal use
|
|
```
|
|
C: RMG 5 1
|
|
S: RMG 5 1
|
|
```
|
|
|
|
#### Group doesn't exist yet
|
|
```
|
|
C: RMG 6 2
|
|
S: 224 6
|
|
```
|
|
|
|
#### Can not remove the initial group
|
|
```
|
|
C: RMG 7 0
|
|
S: 230 7
|
|
```
|
|
|
|
#### Can not remove out-of-bounds groups
|
|
```
|
|
C: RMG 8 30
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
### With group GUIDs
|
|
*Since [MSNP10](../versions/msnp10.md) with `ABCHMigrated: 1`.*
|
|
|
|
#### Normal use
|
|
```
|
|
C: RMG 9 f60efbe7-94af-4b16-b926-e4e10878d329
|
|
S: RMG 9 f60efbe7-94af-4b16-b926-e4e10878d329
|
|
```
|
|
|
|
#### Group doesn't exist yet
|
|
```
|
|
C: RMG 10 11111111-2222-3333-4444-555555555555
|
|
S: 224 10
|
|
```
|
|
|
|
#### Can not remove the initial group
|
|
```
|
|
C: RMG 11 d6deeacd-7849-4de4-93c5-d130915d0042
|
|
S: 230 11
|
|
```
|
|
|
|
#### Can not remove out-of-bounds groups
|
|
```
|
|
C: RMG 8 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL!
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
# Known changes
|
|
* [MSNP10](../versions/msnp10.md): Removed the List Version parameter, and with `ABCHMigrated: 1`
|
|
* [MSNP13](../versions/msnp13.md): Removed (automatic disconnect),
|
|
use [Address Book Services](../services/abservice.md)'s `ABGroupDelete` instead.
|