Exchange Provider::MailDisableContact

  • Article

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

  • Finds the responsible organization by looking at the contact's otherWellKnownGuids attribute. The method then looks at the organization's otherWellKnownGuids to find the GAL for the organization and removes the organization's GAL from the showInAddressBook attribute of the contact.

  • Finds the AL for the organization in the manner stated above and then removes the organization's AL from the showInAddressBook attribute of the contact.

  • Removes the organization from the otherWellKnownObjects attribute of the contact.

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.

Remarks

Rollback Calls

The MailDisableContact method provides no transaction rollback calls.

Sample Code

Example XML Request

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

<request> 
    <data/> 
        <procedure> 
            <execute namespace='Exchange Provider' 
             procedure='MailDisableContact'> 
                <executeData> 
                <path>LDAP://OU=litware,OU=consolidatedmessenger,                                          DC=fabrikam,DC=com 
                </path> 
                <cn>DL1</cn> 
                </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::MailEnableContact