msnp-wiki/docs/commands/gtc.md
yellows111 ce7c3bee1c
0.2.0: The Winter Roll-up
i have basically touched every file help

* Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time.
* Rename passport (soap) to RST
* Formatting changes (many)
* Several corrections
* change git host because git.kevinthe.horse seems Dead
2024-12-18 20:16:29 +00:00

56 lines
1.3 KiB
Markdown

# Introduction
`GTC` is a command introduced with [MSNP2](../versions/msnp2.md).
It is a Notification Server command, without either a request or response payload.
It modifies whenever your client handles new users in your Reverse List (RL).
# Client/Request
`GTC TrID [ A | N ]`
# Server/Response
`GTC TrID {list-version} [ A | N ]`
Where `list-version` is the new List Version. Removed since [MSNP10](../versions/msnp10.md) in `ABCHMigrated: 1` mode.
# Examples
## Setting to A (Ask before adding to AL/BL)
```
C: GTC 1 A
S: GTC 1 256 A
```
## Setting to N (Automatically add to AL)
```
C: GTC 2 N
S: GTC 2 257 N
```
## Already in that mode
```
C: GTC 3 A
S: GTC 3 258 A
C: GTC 4 A
S: 218 4
```
## Invalid argument
```
C: GTC 5 B
```
Server disconnects client.
## Command removed
*Since [MSNP13](../versions/msnp13.md).*
```
C: GTC 6 A
```
Server disconnects client.
# Known changes
* [MSNP10](../versions/msnp10.md) and higher: List Versions are dropped in `ABCHMigrated: 1` mode.
* [MSNP13](../versions/msnp13.md): Removed (automatic disconnect),
set the `MSN.IM.GTC` annotation's value to either 0 or 1 with the
[Address Book Service](../services/abservice.md)'s
[`ABContactUpdate`](../services/abservice/abcontactupdate.md) action on your own GUID instead.