Windows-based Hosting::RemovePlansFromCustomer

  • Article

The RemovePlansFromCustomer procedure removes service plans from a customer organizational unit and releases any resources as necessary.

Arguments

The RemovePlansFromCustomer procedure requires the following input parameters.

Input Argument Description

<org>

The Lightweight Directory Access Protocol (LDAP) path of the organization that will own the Web site.

<plans>/<planName>

One or more valid service plans that will be removed from the customer.

<preferredDomainController>

The name of the preferred domain controller.

Output Arguments

The RemovePlansFromCustomer procedure has no return values.

Remarks

Security

The RemovePlansFromCustomer procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for OrgCreator permissions.

Process Steps

The following steps occur when removing plans from a customer with the RemovePlansFromCustomer procedure of the Managed Windows-based Hosting Namespace:

  • Remove service plans from a customer.

  • Call appropriate resource management procedures to release reserved resources based on the removed plans.

Sample Code

Example XML Request

The following is an example of an XML request for the RemovePlansFromCustomer procedure of the Managed Windows-based Hosting Namespace:

<request> 
        <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="RemovePlansFromCustomer" impersonate="1"> 
                        <executeData> 
                                <preferredDomainController>AD01.fabrikam.com 
                                </preferredDomainController> 
                                <org>LDAP://OU=northwindtraders,OU=consolidatedmessenger, 
                                OU=Hosting,DC=fabrikam,DC=Com</org> 
                                <plans> 
                                        <planName>BasicWebSite</planName> 
                                        <planName>add5MegWebStorage</planName> 
                                        <planName>BasicWSSSite</planName> 
                                </plans> 
                        </executeData> 
                </execute> 
        </procedure> 
</request>

Applies To

Managed Windows-based Hosting Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Windows-based Hosting::AddPlansToCustomer
Windows-based Hosting::ChangeCustomerPlan