Difference between revisions of "AddUserContacts()"

Latest revision as of 12:55, 22 August 2008

This function will add one or more contacts to the address book of a particular user. The associative array of address book contacts should be as follows:

   array[0]["owner"]="userid@domainname"  -- the same User ID and Domain name passed to the function as strings
   array[0]["firstname"]="John"           -- First name of contact
   array[0]["email"]="hisemail@hisdomain" -- Email address of contact
   array[1]["owner"]="userid@domainname"
   array[1]["firstname"]="Sally"
   array[1]["email"]="heremail@herdomain"
   array[1]["favorite"]="1"               -- Add this person to the list of frequent/favorite contacts
   ...

   Permitted columns/associate array elements are:
   firstname, lastname, email, email2, email3, b_phone, h_phone, m_phone, fax, b_street1,
   b_street2, b_city, b_state, b_zip, b_country, h_street1, h_street2, h_city, h_state, h_zip,
   h_country, favorite, notes

Input Parameters

Four strings, an array of contacts, and one result integer:

   Administrative username,
   Administrative password,
   Domain name,
   User ID (the portion of the email address before the @ symbol),
   Address array (associative, see above for format),

   Result (int)

Return Values

If successful, the return value of the function will be 1.

Consult the Result Code Table for a list of result codes and their meaning.