Share via


Hosted Exchange::DeleteSMTPDomain

This procedure deletes a SMTP Domain from a specified organization.

Arguments

Input argument Required Description

<path>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the organization.

<preferredDomainController>

Yes

<SMTPDomain>

Yes

The SMTP Domain.

<deleteSMTPDomain/>

No

Optional parameter. If present the procedure will delete the domain from Exchange Recipient policies. If not present, then the event sink is assumed and no recipient policy is deleted.

Note

The <deleteSMTPDomain/> element name is counterintuitive. I would prefer <deleteRecipientPolicy/>, but this tag name was established with HVE 1.1 as a mechanism for optionally deleting a recipient policy for a domain at organization deletion. In the interest of maintaining consistency, I have used the established element name.

Remarks

Security

  • Impersonate caller.

  • Caller Tested for OrgCreator permissions.

Sample Code

Example XML Request

<?xml version="1.0" encoding="iso-8859-1" ?> 
<request>   
        <procedure>       
                <execute namespace="Hosted Exchange" procedure="DeleteSMTPDomain" impersonate="1">       
                        <executeData>         
                                <path>LDAP://ou=alpineskihouse,OU=consolidatedmessenger,OU=Hosting,DC=fabrikam,DC=Com</path>         
                                <SMTPDomain>SkiHouse.com</SMTPDomain>         
                                <preferredDomainController>AD01.fabrikam.com</preferredDomainController>        
                                <deleteSMTPDomain/>       
                        </executeData>       
                        <after source="executeData" destination="data" mode="merge"/>     
                </execute>   
        </procedure> 
</request> 

Example XML Response

No example XML response.

Applies To

Hosted Exchange Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

See also

Tasks

Hosted Exchange::CreateSMTPDomain