Exchange Provider::MailEnableContact

  • Article

The MailEnableContact method mail-enables an existing contact. This method also performs the following tasks related to address lists:

  • Checks the otherWellKnownGuids property on the parent container to verify if a WKGUID=9E444526CB6F4d5c9A59C9A84E26B627 is set on the organization. If so, the method appends the DN of the well-known-object to the showInAddressBook. This is the hosted organization AL.

  • Checks the otherWellKnownGuids property on the parent container to verify if a WKGUID=89FB25B7DF784fc198A493E2E8A0EE7E is set on the organization. If so, the method appends the DN of the well-known-object to the showInAddressBook. This is the hosted organization GAL.

  • Sets the parent container as an otherWellKnownObjects attribute on the contact, by using the value: WKGUID=B7AE2ABCCBAD41a28973559FCA154DB0.

Arguments

Input argument Required Description

Path

Yes

The Lightweight directory access protocol (LDAP) path of the organization; must be either a container or an OU.

CN

Yes

The contact's CN.

TargetAddress

Yes

The SMTP address used by the transport protocol to deliver mail to the contact.

ProxyAddress

Yes

An SMTP address that must be unique across the Exchange organization. To allow two different customers to have the same contact, the proxyAddress attribute must different, but the target address the same. One way to do this is to set the right-hand side of the proxy address to the customer's SMTP domain and make the left-hand side unique.

Remarks

Rollback Calls

The MailEnableContact method provides no transaction rollback calls.

Comments

The MailEnableContact method supports the following:

  • Identical contacts in two different hosted organizations (the same Exchange organization).

  • A contact corresponding to a user in a different hosted organization (same Exchange organization).

Sample Code

Example XML Request

The following is an example of an XML request for the MailEnableContact method of the Exchange Provider:

<request> 
    <data/> 
        <procedure> 
            <execute namespace='Exchange Provider' 
             procedure='MailEnableContact'> 
               <executeData> 
               <path>LDAP://OU=litware,OU=consolidatedmessenger,                                          DC=fabrikam,DC=com 
               </path> 
               <cn>johnc</cn> 
               <targetAddress>johnc@other.com</targetAddress> 
               <proxyAddress>johnc_local@litware.com</proxyAddress> 
               </executeData> 
           </execute> 
       </procedure> 
</request>

Example XML Response

No example XML response.

Applies To

Exchange Provider API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

See also

Tasks

Exchange Provider::MailDisableContact