# Table of contents:
- Introduction
- Client/Request
- Server/Response
- Examples
- Known changes
# 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}
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
# 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.
# Known changes
-
[MSNP13]: Removed, use a combination of ADL and
Address Book Service
's
ABContactAdd
instead.