msnp-wiki/docs/commands/ver.md

46 lines
1.3 KiB
Markdown
Raw Normal View History

`VER` is a command introduced with [MSNP2](../versions/msnp2.md).
It is a Dispatch Server and Notification Server command, without either a request payload or response payload.
It specifies which protocols the client can accept, and which one the server likes the best.
# Client/Request
```
VER TrID dialect-name {dialect-name ...}
```
Where (possibly multiple) dialect-name(s) being the versions of the protocol your client can use.
# Server/Response
```
VER TrID preferred-dialect-name
```
Where `preferred-dialect-name` is the preferred version of the protocol the server will continue to use. The highest is usually preferred, unless it isn't supported by the server.
If the server's `preferred-dialect-name` is `0`, that means it doesn't want to use any of the protocols you have specified. A forced disconnect is to be expected in this circumstance.
This command can only be sent once. Any further uses of this command in the same session is Undefined Behavour.
# Examples
## Unsupported Protocols
```
C: VER 1 DISREGARDANCE FOR A REAL PROTOCOL
S: VER 1 0
```
Server disconnects client.
## Supported Fallback Protocol
```
C: VER 2 MSNP2 CVR0
S: VER 2 CVR0
```
## Supported Primary Protocol
```
C: VER 3 MSNP8 CVR0
S: VER 3 MSNP8
```
# Known changes
* Removed in MSNP24.