53 lines
1.7 KiB
Markdown
53 lines
1.7 KiB
Markdown
|
# Introduction
|
||
|
`SBP` is a command introduced with [MSNP10](../versions/msnp10.md).
|
||
|
|
||
|
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](rea.md).
|
||
|
|
||
|
# Client/Request
|
||
|
`SBP TrID contact-id property value`
|
||
|
|
||
|
Where `contact-id` is the `C=` value from either [ADD](add.md) or [LST](lst.md).
|
||
|
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.
|
||
|
* `HSB`: [MSNP11](../versions/msnp11.md)+: Has blog, changed by the Client Capability.
|
||
|
|
||
|
Where `value` is the URL-encoded value to set the related `property` to.
|
||
|
|
||
|
# Server/Response
|
||
|
`SBP TrID contact-id property value`
|
||
|
|
||
|
Same parameters as the request.
|
||
|
|
||
|
# Examples
|
||
|
|
||
|
## Normal use
|
||
|
|
||
|
### Without GUIDs
|
||
|
*Only with `ABCHMigrated: 0`.*
|
||
|
```
|
||
|
C: SBP 1 anotheruser@hotmail.com MFN another%20user
|
||
|
S: SBP 1 anotheruser@hotmail.com MFN anoter%20user
|
||
|
```
|
||
|
|
||
|
### With GUIDs
|
||
|
*Only with `ABCHMigrated: 1`.*
|
||
|
```
|
||
|
C: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
|
||
|
S: SBP 2 c1f9a363-4ee9-4a33-a434-b056a4c55b98 MFN another%20user
|
||
|
```
|
||
|
|
||
|
## Errors
|
||
|
None are currently known. If you know of one, please contact me.
|
||
|
|
||
|
# Known changes
|
||
|
* [MSNP11](../versions/msnp11.md): Added support for `HSB` property.
|
||
|
* [MSNP13](../versions/msnp13.md): Removed, use [Address Book Service](../services/abservice.md)'s `ABContactUpdate` action instead.
|