msnp-wiki/docs/commands/sbp.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.3 KiB

Introduction

SBP is a command introduced with MSNP10.

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

Sets a buddy's property in your cache to a specified value. For the command this replaced, read REA.

Client/Request

SBP TrID contact-id property value {unknown}

Where contact-id is the C= value from either ADD or LST. If you are using ABCHMigrated: 0, this is the contact's user handle. If you are instead using ABCHMigrated: 1, this is the contact's GUID.

Where property are any of the values:

  • MFN: My Friendly Name
  • MOB: User can contact me via MSN Mobile, changed by the Client Capability.
  • WWE: User can contact me via MSN Direct, changed by the Client Capability.
  • PHM: MSNP11+: The user's mobile phone number.
  • HSB: MSNP11+: Has blog, changed by the Client Capability.

Where value is the URL-encoded value to set the related property to.

Where unknown is set to 1 if setting the property of PHM. Added since MSNP11 (TODO: What does this mean?)

Server/Response

SBP TrID contact-id property value

Same parameters as the request.

Examples

Without GUIDs

Only with ABCHMigrated: 0.

My friendly name

C: SBP 1 anotheruser@hotmail.com MFN another%20user
S: SBP 1 anotheruser@hotmail.com MFN anoter%20user

With GUIDs

Only with ABCHMigrated: 1.

My friendly name

C: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
S: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user

Contact mobile number

Since MSNP11.
TODO: Is this correct? Needs mobile stuff enabled in msgrconfig.

C: SBP 3 c1f9a363-4ee9-4a33-a434-b056a4c55b95 PHM tel:+15554444333 1
S: SBP 3 c1f9a363-4ee9-4a33-a434-b056a4c55b95 PHM tel:+15554444333 1

Errors

None are currently known. If you know of one, please contact me.

Command removed

Since MSNP13.

C: SBP 4 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user

Server disconnects client.

Known changes