msnp-wiki/docs/commands/ans.md

52 lines
1.4 KiB
Markdown
Raw Permalink Normal View History

# Introduction
`ANS` is a command introduced with [MSNP2](../versions/msnp2.md).
It is a Switchboard Server command, without either a request or response payload.
Used to join ("answer") a Switchboard session ("call").
The response of this command sent after the [IRO](iro.md) list has been sent.
# Client/Request
`ANS TrID my-handle cookie session-id`
Where `my-handle` is the current user's handle.
In [MSNP16](../versions/msnp16.md), a UUID is appended after a semi-colon, which is your MPOP Machine ID.
Where `cookie` is the `cookie` from the [RNG](rng.md) command sent to you.
Where `session-id` is the `session-id` from the [RNG](RNG) command sent to you.
# Server/Response
`ANS TrID OK`
Where `OK` is always `OK`.
# Examples
## Answering a RNG
```
S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789 anotheruser@hotmail.com another%20user
C: ANS 1 example@hotmail.com 123456789.123456789.123456789 987654321
S: IRO 1 1 1 anotheruser@hotmail.com another%20user
S: ANS 1 OK
```
## Invalid session
*NOTE: There is no defined behaviour for this command specificially.*
```
C: ANS 2 example@hotmail.com bad data
```
Server disconnects client.
## Invalid context (Notification Server)
*Inherited from being an unimplemented command.*
```
C: ANS 3 example@hotmail.com wrong server
```
Server disconnects client.
# Known changes
* [MSNP16](../versions/msnp16.md): Added the current MPOP Machine ID to the `my-handle` parameter.