Windows-based Hosting::ChangeCustomerPlan

  • Article

The ChangeCustomerPlan procedure changes a customer's service plan to another plan of the same type.

Arguments

The ChangeCustomerPlan 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.

<planName>

The new plan name (must be of the same type as the old plan).

<oldPlanName>

The old plan name.

<preferredDomainController>

The name of the preferred domain controller.

Output Arguments

The ChangeCustomerPlan procedure has no return values.

Remarks

Security

The ChangeCustomerPlan procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for OrgCreator permissions.

Process Steps

The following steps occur when changing a customer service plan with the ChangeCustomerPlan procedure of the Managed Windows-based Hosting Namespace:

  • Verify that plans are of the same type.

  • Update the customer's plan.

  • Modify the customer's allocation quota.

Sample Code

Example XML Request

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

<request> 
        <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="ChangeCustomerPlan" impersonate="1"> 
        <executeData> 
                <preferredDomainController>AD01.fabrikam.com 
                                </preferredDomainController> 
                                <org>LDAP://OU=northwindtraders, OU=consolidatedmessenger, 
                                OU=Hosting,DC=fabrikam,DC=Com</org> 
                                <planName>WebBasic</planName> 
                                <oldPlanName>WebGold</oldPlanName> 
                        </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::RemovePlansFromCustomer