msnp-wiki/docs/commands/snd.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.1 KiB

Introduction

SND is a command introduced with MSNP2.

It is a Notification Server command, without either a request or response payload.

Sends a service invitation to an e-mail address or directory user. For the version of this command that supports friendly names that superseded this command, read SDC.

Client/Request

SND TrID target-address {translation-lcid} {requesting-library} {client-identification}

Where target-address is the E-mail address or index from the last FND response you'd like to invite to the service.

Where translation-lcid is the LCID of the translation you'd like the invitation to be in. Added since MSNP3.

Where requesting-library is the name of the library that sent this SND, usually MSMSGS or MSNMSGR. Added since MSNP3.

Where client-identification is the internal name of the codebase used to create requesting-library, usually MSMSGS. Added since MSNP4.

Server/Response

SND TrID OK

Where OK is always OK.

Examples

Normal use

E-mail only

Only in MSNP2.

C: SND 1 anotheruser@hotmail.com
S: SND 1 OK

With language ID and client library name

Only in MSNP3.

C: SND 2 anotheruser@hotmail.com 0x0409 MSMSGS
S: SND 2 OK

With the client internal name

Since MSNP4.

C: SND 3 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS
S: SND 3 OK
C: FND 4 fname=Another lname=User city=* state=* country=US
S: FND 4 1 2 fname=Another lname=User city=New%20York state=NY country=US
FND 4 2 2 fname=Another lname=User city=Stillwater state=OK country=US
C: SND 5 1 0x0409 MSMSGS MSMSGS
S: SND 5 OK

Invalid parameters

C: SND 6 anotheruser@hotmail.com 10
S: 503 6

Server disconnects client.

Known changes

  • MSNP3: Added translation support and requesting library parameters.
  • MSNP4: Added client codebase parameter.
  • MSNP5: Deprecated. Use SDC instead.