yellows111
f267b61dde
information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny) 18 commands left.
72 lines
2.1 KiB
Markdown
72 lines
2.1 KiB
Markdown
# Introduction
|
|
`SND` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
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](fnd.md) 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](../versions/msnp3.md).
|
|
|
|
Where `requesting-library` is the name of the library that requested this CVR, usually `MSMSGS` or `MSNMSGR`.
|
|
Added since [MSNP3](../versions/msnp3.md).
|
|
|
|
Where `client-identification` is the internal name of the codebase used to create `requesting-library`, usually `MSMSGS`.
|
|
Added since [MSNP4](../versions/msnp4.md).
|
|
|
|
# Server/Response
|
|
`SND TrID OK`
|
|
|
|
Where `OK` is always `OK`.
|
|
|
|
# Examples
|
|
|
|
## Normal use
|
|
|
|
### First generation
|
|
*Only [MSNP2](../versions/msnp2.md).*
|
|
```
|
|
C: SND 1 anotheruser@hotmail.com
|
|
S: SND 1 OK
|
|
```
|
|
|
|
### Second generation
|
|
*Only [MSNP3](../versions/msnp3.md).*
|
|
```
|
|
C: SND 2 anotheruser@hotmail.com 0x0409 MSMSGS
|
|
S: SND 2 OK
|
|
```
|
|
### Third generation
|
|
*Since [MSNP4](../versions/msnp4.md).*
|
|
```
|
|
C: SND 3 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS
|
|
S: SND 3 OK
|
|
```
|
|
|
|
## From a directory search
|
|
```
|
|
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](../versions/msnp3.md): Added translation support and requesting library parameters.
|
|
* [MSNP4](../versions/msnp4.md): Added client codebase parameter.
|
|
* [MSNP5](../versions/msnp5.md): Deprecated in place of SDC.
|