# Table of contents:

# 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 user handle 

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

# Target user not found 

C: ADC 7 FL N=ghost@hotmail.com F=ghost@hotmail.com
S: 208 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