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

SDC is a command introduced with MSNP5.

It is a Notification Server command, WITH a request payload and without a response payload.

Sends a service invitation to an e-mail address or directory user. For the version of this command that does not support friendly names, read SND.

Client/Request

SDC TrID target-address translation-lcid requesting-library client-identification X X my-friendly-name length
payload

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.

Where requesting-library is the name of the library that sent this SDC, usually MSMSGS or MSNMSGR.

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

Where both X parameters are always X.

Where my-friendly-name is your current friendly name. Invalid escaped characters are forcefully re-encoded to%3DXX, where XX is original escaped character code.

Where length is the size (in bytes) of the payload. Set to 0 if you don't want to add anything else to your invitation.

Where payload is plain-text data that is included in the invitation. If the length is 0, the payload is not to be set.

Server/Response

SDC TrID OK

Where OK is always OK.

Examples

Normal use without extra data

C: SDC 1 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS X X example%20name 0
S: SDC 1 OK

Normal use with extra data

C: SDC 2 anotheruser@hotmail.com 0x0409 MSMSGS MSMSGS X X example%20name 37
This will be added to the invitation.
S: SDC 2 OK

From a directory search without extra data

C: FND 3 fname=Another lname=User city=* state=* country=US
S: FND 3 1 2 fname=Another lname=User city=New%20York state=NY country=US
FND 3 2 2 fname=Another lname=User city=Stillwater state=OK country=US
C: SDC 4 1 0x0409 MSMSGS MSMSGS X X example%20name 0
S: SDC 4 OK

From a directory search with extra data

C: FND 5 fname=Another lname=User city=* state=* country=US
S: FND 5 1 2 fname=Another lname=User city=New%20York state=NY country=US
FND 5 2 2 fname=Another lname=User city=Stillwater state=OK country=US
C: SDC 6 1 0x0409 MSMSGS MSMSGS X X example%20name 54
Hello! I met you the other day and would like to chat.
S: SDC 6 OK

Invalid parameters

C: SDC 7 anotheruser@hotmail.com 10
S: 503 7

Server disconnects client.

Known changes

None.