msnp-wiki/docs/commands/adg.md
yellows111 f267b61dde
ILN, NLN, REA, SND, ADG, LSG, and MSNP4 changes
information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny)

18 commands left.
2024-10-18 23:52:48 +01:00

3.2 KiB

Introduction

ADG is a command introduced with MSNP7.

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

Creates a new group. Replaced with Address Book Service's ABCreateGroup in MSNP13.

Client/Request

ADG TrID group-name {0}

Where group-name is the name of the group you'd like to create. Has a limit of 61 bytes (URL encoded characters count as 3 bytes).

Where 0 is always 0.. Removed in MSNP10.

Server/Response

ADG TrID {list-version} group-name group-id {0}

Where list-version is the new List Version. Removed in MSNP10.

Where group-id is your new group's identification number.

Where 0 is always 0. Removed in MSNP10.

Examples

With list versions

Only in MSNP7 to MSNP9.

Normal use

C: ADG 1 New%20Group%201 0
S: ADG 1 256 New%20Group%201 29 0

Cannot create more than 30 groups

C: ADG 2 New%20Group%202 0
S: 223 2

Group name too long

C: ADG 3 This%2062%20character%20group%20name%20is%20%invalid.%20There. 0
S: 229 3

Group name extremely long

NOTE: This has been line-breaked. Lines beginnging with .. followed by a space are continuations of the previous line.

C: ADG 3 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA 0

Server disconnects client.

Without list versions

With group IDs

Only MSNP10 with ABCHMigrated: 0.

Normal use

C: ADG 4 Friends
S: ADG 4 Friends 1

Cannot create more than 30 groups

C: ADG 5 New%20Group%203
S: 223 2

Group name too long

C: ADG 6 This%2062%20character%20group%20name%20is%20%invalid.%20There.
S: 229 6

Group name extremely long

NOTE: This has been line-breaked. Lines beginnging with .. followed by a space are continuations of the previous line.

C: ADG 7 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA

Server disconnects client.

With group GUIDs

Since MSNP10 with ABCHMigrated: 1.

Normal use

C: ADG 8 Friends
S: ADG 8 Friends f60efbe7-94af-4b16-b926-e4e10878d329

Cannot create more than 30 groups

C: ADG 9 New%20Group%203
S: 223 9

Group name too long

C: ADG 10 This%2062%20character%20group%20name%20is%20%invalid.%20There.
S: 229 10

Group name extremely long

NOTE: This has been line-breaked. Lines beginnging with .. followed by a space are continuations of the previous line.

C: ADG 11 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA

Server disconnects client.

Known changes

  • MSNP10: Removed unused 0 parameter, Returns a GUID instead of a Group ID if ABCHMigrated: 1.
  • MSNP13: Removed (automatic disconnect), use Address Book Service's ABCreateGroup instead.