msnp-wiki/docs/commands/snd.md

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 requested this CVR, 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

First generation

Only MSNP2.

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

Second generation

Only MSNP3.

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

Third generation

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 in place of SDC.