Exchange Provider::MailDisableGroup

The MailDisableGroup method mail-disables a group. The 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 attribute to find the GAL for the organization and removes the organization's GAL from the showInAddressBook attribute of the group.

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

  • 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 CN of the group to mail disable.

Remarks

Rollback Calls

The MailDisableGroup method calls the MailEnableGroup method on transaction rollback.

Sample Code

Example XML Request

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

<request> 
    <data/> 
        <procedure> 
            <execute namespace='Exchange Provider' 
             procedure='MailDisableGroup'> 
                <executeData> 
                <path>LDAP://OU=litware,OU=consolidatedmessenger, 
                 DC=fabrikam,DC=com 
                </path> 
                <cn>DL1</cn> 
                </executeData> 
            </execute> 
        </procedure> 
</request> 

Example XML Request

No example XML request.

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::MailEnableGroup