msnp-wiki/docs/commands/ans.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

1.5 KiB

Introduction

ANS is a command introduced with MSNP2.

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 list has been sent.

Client/Request

ANS TrID my-handle{;machine-guid} cookie session-id

Where my-handle is the current user's handle.

Where ;machine-guid is a bracketed Machine GUID. Added since MSNP16.

Where cookie is the cookie from the RNG command sent to you.

Where session-id is the session-id from the RNG command sent to you.

Server/Response

ANS TrID OK

Where OK is always OK.

Examples

Answering a RNG

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

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: Added the current MPOP Machine ID to the my-handle parameter.