Hosted Email 2007::CreateConsumerVanityDomain

  • Article

This procedure creates a vanity domain for a consumer user.

Arguments

Input Arguments Required Description

<user>

Yes

A valid Lightweight Directory Access Protocol (LDAP) path of the user object.

<name>

Yes

The name of the user (used to generate the new SMTP email address by combining name with SMTPDomain).

<SMTPDomain>

Yes

A valid SMTP domain name.

<preferredDomainController>

Yes

The name of the preferred domain controller.

Remarks

Security

The caller must be at least a member of role: UserCreators.

Schema Definition

Input

<executeData>  
<user>1..1 </user> 
<name>1..1 </name> 
<SMTPDomain>1..1 </SMTPDomain> 
<preferredDomainController>1..1 </preferredDomainController> 
</executeData>

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--A valid LDAP path of the user object. --> 
    <user>LDAP://CN=jack@litwareinc.com,OU=LitwareInc,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user> 
    <!--The name of the user (used to generate the new SMTP email address by combining name with SMTPDomain).   --> 
    <name>jack</name> 
    <!--A valid domain name. --> 
    <SMTPDomain>Litware.com</SMTPDomain> 
    <!--The name of the preferred domain controller. --> 
    <preferredDomainController>AD01.Fabrikam.com</preferredDomainController> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="CreateConsumerVanityDomain" impersonate="1"> 
      <before source="data" sourcePath="user" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="name" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="SMTPDomain" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response>  
        <data /> 
</response>

Applies To

Hosted Email 2007 Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Other Resources

API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]