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

2.5 KiB

Introduction

RNG is a command introduced with MSNP2.

It is a Notification Server command, without a response payload.

Used to invite ("ring") you to a Switchboard session.

Client/Request

This command can not be sent from the client.

Server/Response

RNG session-id address:port CKI cookie inviter-handle inviter-friendly-name {U} {domain} {direct-connect}

Where session-id is the Switchboard session identification number you need in ANS.

Where address:port is the server you need to connect to join the conversation.

Where CKI is always CKI.

Where cookie is the Switchboard cookie, to be used in USR and ANS.

Where inviter-handle is the inviter's handle.

Where inviter-handle is the inviter's friendly name.

Where U is always U. Since MSNP13.
The use of this parameter is unknown.

Where domain is always messenger.hotmail.com. Since MSNP13.
The use of this parameter is unknown.

Where direct-connect is set to one of these two values, Since MSNP14:

  • 0: This address:port can only be accessed only via the HTTP Gateway.
  • 1: This address:port can be connected to via TCP as well as the HTTP Gateway.

Examples

Getting a Switchboard invite

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

Old

Only in MSNP2 to MSNP12.

S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789
.. anotheruser@hotmail.com another%20user

New

Only in MSNP13.

S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789
.. anotheruser@hotmail.com another%20user U messenger.hotmail.com

Modern

Since MSNP14.

S: RNG 987654331 10.0.1.200:1865 CKI 123456789.123456789.123456789
.. anotheruser@hotmail.com another%20user U messenger.hotmail.com 1

Invalid context

Inherited from being an unimplemented command.

C: RNG 1

Server disconnects client.

Known changes

  • MSNP13: Added two new parameters, one of which is always U, and the other is always messenger.hotmail.com.
  • MSNP14: Added a new parameter that is either 0 or 1 to denote whenever the client should directly connect to the address, or use the HTTP Gateway to connect instead.