yellows111
/
msnp-wiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
msnp-wiki/docs/commands/adc.md

4.5 KiB
Raw Blame History

Introduction

ADC is a command introduced with MSNP10.

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

Adds a user to a list. For the command that was replaced with this, read ADD. For the command that replaced this command in MSNP13, read ADL. For the service that complements ADL, read about the Address Book Service.

Client/Request

Add to a list

ADC TrID [ FL | AL | BL | RL ] N=user-handle {F=stored-friendly-name}

Where user-handle is the target's user handle.

Where stored-friendly-name is the friendly name you'd like to store. Only applies if the target list is the Forward List. It and the F= prefix are omitted otherwise.

Add to a group

ADC TrID FL C=contact-id group-id

Where contact-id is the contact's ID associated with the user on your Forward List (FL). If in ABCHMigrated: 0, this is the contact's user handle, otherwise in ABCHMigrated: 1, it is the contact's GUID.

Where group-id is the identification number of the group you'd like to add the contact to. If in ABCHMigrated: 0, this is the group's numeric ID, otherwise in ABCHMigrated: 1, it is the group's GUID.

Server/Response

Successfully added to list

ADC TrID [ FL | AL | BL | RL ] N=user-handle {F=stored-friendly-name} {C=contact-id}

If this is an asynchronous use of this command, the Transaction ID (or TrID) will be set to 0.

Where contact-id is the contact's ID associated with the user. Only applies to users added to the Forward List. If in ABCHMigrated: 0, this is the contact's user handle, otherwise in ABCHMigrated: 1, it is the contact's GUID.

Successfully added to group

ADC TrID FL C=contact-id group-id

Same parameters as the request.

Examples

Normal use

Add to other lists

Does not apply for the Forward List (FL).

C: ADC 1 AL N=anotheruser@hotmail.com
S: ADC 1 AL N=anotheruser@hotmail.com

Add to the Forward List

Without GUIDs

Only with ABCHMigrated: 0.

C: ADC 2 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com
S: ADC 2 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com C=anotheruser@hotmail.com

With GUIDs

Only with ABCHMigrated: 1.

C: ADC 3 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com
S: ADC 3 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com C=c1f9a363-4ee9-4a33-a434-b056a4c55b98

A telephone number

Since MSNP11 if <MobileMessaging> is set correctly in the Messenger Config.

C: ADC 4 FL N=tel:15551111222 F=john
S: ADC 4 FL N=tel:15551111222 F=john C=a47e39cf-312c-4100-94a6-f2b33adf5b68

Add to a group

Only applies to the Forward List (FL).

Without GUIDs

Only with ABCHMigrated: 0.

C: ADC 4 FL C=anotheruser@hotmail.com 1
S: ADC 4 FL C=anotheruser@hotmail.com 1

With GUIDs

Only with ABCHMigrated: 1.

C: ADC 5 FL C=anotheruser@hotmail.com f60efbe7-94af-4b16-b926-e4e10878d329
S: ADC 5 FL C=anotheruser@hotmail.com f60efbe7-94af-4b16-b926-e4e10878d329

Invalid handle

C: ADC 6 FL N=a@b F=a@b
S: 201 6

Account not found

C: ADC 7 FL N=ghost@hotmail.com F=ghost@hotmail.com
S: 205 7

Target list is full

C: ADC 8 FL N=stuffed@hotmail.com F=stuffed@hotmail.com
S: 210 8

User already in that list

C: ADC 9 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com
S: 215 9

User can not be in both lists

C: ADC 10 BL N=anotheruser@hotmail.com
S: 219 10

Group doesn't exist

Without GUIDs

Only with ABCHMigrated: 0.

C: ADC 11 FL C=anotheruser@hotmail.com 31
S: 224 11

With GUIDs

Only with ABCHMigrated: 1.

C: ADC 12 FL C=anotheruser@hotmail.com 00000000-0000-0000-0000-000000000000
S: 224 12

You can not modify the Pending List

C: ADC 13 PL N=anotheruser@hotmail.com

Server disconnects client.

Removed

C: ADC 14 FL N=anotheruser@hotmail.com F=anotheruser@hotmail.com

Server disconnects client.

Asynchronous update

S: ADC 0 RL N=anotheruser@hotmail.com F=another%20user

Known changes