Protocols/MSNP/Commands/ADD

From NINA Wiki
Jump to navigation Jump to search
MSNP Protocol
IntroductionTermsClients
Reference
Error ListCommandsRelying Party SuiteSpotlife
Services
XMPPHTTP GatewayTabsActivities
Documentation
Development ToolsMSNP Grid
PolygamyURLs used by MSN
Documents
Protocol Versions
Version 21
Version 18
Version 16
Version 15
Version 14
Version 13
Version 12
Version 11
Version 9
Version 8
Version 2
MSNC
IntroductionP2PObject DescriptorDisplay PicturesFile Transfer
Scenarios
Microsoft Messenger for Mac
MSNP on WebTV (MSNTV)

ADD

SUMMARY

Adds a principal to one's contact list.

SYNTAX

 ADD trid list email display-name [group-num]
  • list: one of "AL", "BL", "FL".

RESPONSE

 ADD trid list ver-num email display-name [group-num]
  • ver-num: Was used to support revision numbers of the contacts list, but now 1 since the feature was dropped.

DESCRIPTION

The principal with the specified email is added to the specified list with the specified name. If adding to the FL, it is optionally added to the group specified (or group 0 if no group is specified.)

ERRORS

  • 201: Invalid email address
  • 205: Nonexistent principal
  • 210: Limit of 300 principals exceeded
  • 215: Principal already in group
  • 219: User cannot be in AL and BL simultaneously
  • 224: Nonexistent group

Attempting to add principals to one's RL will cause disconnection.

VERSION

MSNP8, MSNP9

Deprecated in MSNP11: see ADC and MSNP11 changes