3.0 KiB
Introduction
LSG is a command introduced with MSNP7.
It is a Notification Server command, without a request or response payload.
It retrieves all groups.
Client/Request
LSG TrID
Server/Response
Outside of SYN
LSG TrID list-version index size-of-list group-id group-name 0
Where list-version is the current List Version.
Where index is a number that can not go out of size-of-list.
If you have not added any groups, this value is always 1.
Where size-of-list is the upper bounds for index.
If you have not added any groups, this value is always 1.
Where group-id is the relevant group's identification number, allowed values are 0 to 29.
If you have not added any groups, this value is always 0.
Where group-nameis the relevant group's display name, URL encoded if needed, up to 61 bytes.
If you have not added any groups, this value is always ~.
Where 0 is always 0.
In SYN
First generation
Applies for MSNP7.
Same as the response outside of SYN.
Second generation
LSG group-id group-name 0
Third generation
Since MSNP10.
LSG group-name [ group-id | group-guid ]
Where group-id is the group's identification number.
If ABCHMigrated: 1 is set in the initial profile,
it is instead group-guid, which is the group's GUID.
Examples
Client-initiated
No groups created
NOTE: Specifiying this as the LSG in SYN will cause the client to attempt to re-initialize the default groups. Please review the SYN page for what the client attempts to do here.
C: LSG 1
S: LSG 1 255 1 1 0 ~ 0
Have created groups
C: LSG 2
S: LSG 2 255 1 2 0 Other%20Contacts 0
S: LSG 2 255 2 2 1 Friends 0
From SYN
Main article: SYN.
Using first generation
Only in MSNP7.
C: SYN 3 0
S: SYN 3 4
...
S: LSG 3 4 1 2 0 Other%20Contacts 0
S: LSG 3 4 2 2 1 Friends 0
Using second generation
C: SYN 4 0
S: SYN 4 5
...
S: LSG 0 Other%20Contacts 0
S: LSG 1 Friends 0
Using third generation, with IDs
Only in MSNP10 with ABCHMigrated: 0.
C: SYN 5 0 0
S: SYN 5 6 0 1 2
...
S: LSG Other%20Contacts 0
S: LSG Friends 1
Using third generation, with GUIDs
Since MSNP10 with ABCHMigrated: 1.
C: SYN 6 0 0
S: SYN 6 2024-10-17T11:46:35.1100000-07:00 2024-10-17T11:46:35.1100000-07:00 1 2
...
S: LSG Other%20Contacts d6deeacd-7849-4de4-93c5-d130915d0042
S: LSG Friends f60efbe7-94af-4b16-b926-e4e10878d329