# Table of contents:
- Introduction
- Client/Request
- Server/Response
- Examples
- Known changes
# Introduction
REG
is a command introduced with
MSNP7
It is a Notification Server command, without either a request or response payload.
Renames an existing group. Replaced with
Address Book Service's
ABGroupUpdate
in
MSNP13.
# Client/Request
REG TrID group-id new-group-name {0}
Where
group-id
is the group's identification number.
With
ABCHMigrated: 1
, this is instead the group's GUID.
Where
new-group-name
is the name you want to rename
group-id
to.
Has a limit of 127 bytes (URL-encoded characters count as 3 bytes).
Where
0
is always
0
. Removed in
MSNP10.
# Server/Response
REG TrID {list-version} group-id group-name {0}
Where
list-version
is the new List Version. Removed in
MSNP10
Where
group-name
is the updated name of the group.
# Examples
# With list versions
# Normal use
C: REG 1 0 example%20group%20rename 0
S: REG 1 256 0 example%20group%20rename 0
# Cannot rename group that doesn't exist yet
C: REG 2 2 non-existant%20group 0
S: 224 2
# Cannot rename out-of-bounds groups
C: REG 3 30 example%20out%20of%20bounds%20group 0
Server disconnects client
# Group name extremely long
NOTE: This has been line-breaked.
Lines beginnging with
..
followed by a space are continuations of the previous line.
C: REG 4 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAA 0
Server disconnects client.
# Without list versions
# With group IDs
Only in
MSNP10
with
ABCHMigrated: 0
.
# Normal use
C: REG 5 0 another%20example%20group%20rename
S: REG 5 0 another%20example%20group%20rename
# Cannot rename group that doesn't exist yet
C: REG 6 2 still%20a%20non-existant%20group
S: 224 6
# Cannot rename out-of-bounds groups
C: REG 7 30 still%20out%20of%20bounds
Server disconnects client.
# Group name extremely long
NOTE: This has been line-breaked.
Lines beginnging with
..
followed by a space are continuations of the previous line.
C: REG 8 0 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAA
Server disconnects client.
# With group GUIDs
Since
MSNP10
with
ABCHMigrated: 1
.
# Normal use
C: REG 9 d6deeacd-7849-4de4-93c5-d130915d0042 yet%20another%20example%20group%20rename
C: REG 9 d6deeacd-7849-4de4-93c5-d130915d0042 yet%20another%20example%20group%20rename
# Cannot rename group that doesn't exist yet
C: REG 10 11111111-2222-3333-4444-555555555555 still%20a%20non-existant%20group
S: 224 10
# Cannot use an invalid GUID
C: REG 11 THIS0IS0-NOT0-A0VA-LID0-GUID0AT0ALL! very%20invalid%20GUID%20there
Server disconnects client.
# Group name extremely long
NOTE: This has been line-breaked.
Lines beginnging with
..
followed by a space are continuations of the previous line.
C: REG 12 d6deeacd-7849-4de4-93c5-d130915d0042 AAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
Server disconnects client.
# Known changes
-
MSNP10: Removed unused
0
parameter, removed List Versions, and withABCHMigrated: 1
, changed group IDs to GUIDs. -
MSNP13: Removed (automatic disconnect),
use
Address Book Service's
ABGroupUpdate
instead.