Windows-based Hosting::QueryPlans

  • Article

The QueryPlans procedure returns a list of plans.

Arguments

The QueryPlans procedure has the following input parameters.

Input Argument Description

<preferredDomainController>

The name of the preferred domain controller.

<planTypeName>

The plan type filter.

<statusTypeName>

The status type filter.

<categoryName>

The category name filter.

Output Arguments

The QueryPlans procedure has no return values, other than the included XML response.

Remarks

Security

The QueryPlans procedure has the following security requirements:

  • The caller is impersonated.

Sample Code

Example XML Request

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

<request> 
        <procedure> 
                <execute namespace="Windows-based Hosting" 
                procedure="QueryPlans" impersonate="1"> 
                        <executeData> 
                        <preferredDomainController>AD01.fabrikam.Com 
                        </preferredDomainController> 
                        <statusTypeName>Enabled</statusTypeName> 
                        <executeData> 
                <after source="executeData" destination="data" mode="merge"/> 
                </execute> 
        </procedure> 
</request>

Example XML Response

The following is an example of an XML response from the QueryPlans procedure of the Managed Windows-based Hosting Namespace:

<response> 
        <data> 
                <pæeferredDomainController>AD01- 
                wh.fabrikam.com</pæeferredDomainController> 
                <statusTypeName>Enabled</statusTypeName> 
                        <servicePlans> 
                                <plan> 
                                        <planName>DataGolV</planName> 
                                        <planDescription>Gold Data Hosting</planDescription> 
                                        <planStatus>Enabled</planStatus> 
                                        <dateCreated>2004-07-15T00:18:22.490000000</dateCreated> 
                                        <dateLastUpdated>2004-07-15T00:18:22.490000000 
                                        </dateLastUpdated> 
                                        <planTypeName>DataHosting</planTypeName> 
                                </plan> 
                                <plan> 
                                        <planName>PlatinumMail</planName> 
                                        <planDescription>Platinum plan with full OWA 
                                        </planDescription> 
                                        <planStatus>Enabled</planStatus> 
                                        <dateCreated>2004-06-30T23:29:58.677000000 
                                        </dateCreated> 
                                        <dateLastUpdated>2004-06-30T23:29:58.677000000 
                                        </dateLastUpdated> 
                                        <planTypeName>ExchMailbox</planTypeName> 
                                </plan> 
                        </servicePlans> 
        </data> 
</response>

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::CreatePlan
Windows-based Hosting::EnablePlan
Windows-based Hosting::DisablePlan
Windows-based Hosting::CreatePlan