Exchange Provider API
This document provides the details of the Application Programming Interface (API) for the Exchange Provider included with the Microsoft Provisioning System (MPS) component of the , including Hosted Exchange 2003. The document describes the Exchange Provider methods along with input parameters, transaction rollback calls, and other requirements. For each Exchange Provider method, an XML request is also included as an example which can be submitted to MPS.
Developers should use this API document as a reference when creating MPS procedures, custom namespaces, or XML requests that initiate provisioning tasks to manipulate Exchange functionality on a Microsoft Windows Server 2003 or Microsoft Windows 2000 Server.
The Exchange Provider component of MPS contains the programmatic logic to communicate directly with the management interface of Microsoft Exchange Server 2003 . Calls to Exchange Provider methods are handled through the Exchange Provider namespace, which is a dedicated namespace that works with the Exchange Provider to implement provisioning tasks.
To call the methods of the Exchange Provider, you can write an XML request that contains procedures associated with the Exchange Provider namespace, the Hosted Exchange 2003 Namespace, or another custom namespace that you develop. You can also call into the Exchange Provider from the Web Service included with Microsoft Solutions for Hosted Messaging and Collaboration. The Web Service exposes select public methods of the Hosted Exchange 2003 Namespace as Web methods, which can call Exchange Provider methods.
For calls into the Exchange Provider from the Web Service, you can make use of the MPS .NET Client Wrapper API component to generate XML requests containing specific Hosted Exchange Namespace procedures. You then submit these requests into MPS to initiate Exchange-related provisioning tasks. For further details about the API for the MPF .NET Client Wrapper, see "MPF .NET Client Wrapper API" in this volume.
You can install the Exchange Provider with the MPS Deployment Tool, provided with Microsoft Solutions for Hosted Messaging and Collaboration.
Allows you to create or modify a recipient policy to contain the customer's Simple Mail Transfer Protocol (SMTP) domain (for example, litware.com).
Deletes the SMTP domain(s) for an organization.
Deletes all user mailboxes in a given organizational unit (OU).
Mailbox-enables an existing user.
Deletes a user's mailbox.
Mail-enables an existing contact.
Mail-disables an existing contact.
Mail-enables a group, which effectively turns the group into a distribution list.
Mail-disables a group.
Moves a mailbox from one mailbox store to another by looking up the user's current mailbox location and moving it to the new destination.
Allows you to edit mailbox settings.
Allows you to create a folder within a Messaging Application Programming Interface (MAPI) top-level hierarchy (TLH) and assign permissions.
Deletes a folder under a MAPI TLH.
Modifies folder parameters such as quotas, in addition to setting permissions for a folder in a MAPI TLH.
Creates a Global Address List (GAL) and applies permissions.
Removes the GAL from the All Global Address Lists and also updates the Exchange configuration container to reflect the changes.
Creates an offline address list (OAL) for customers.
Deletes the OAL for customers.
Rebuilds an offline address list for customers.
Creates an address list in the All Address Lists container and also sets permissions.
Deletes the address list from the All Address Lists container.
Creates a virtual directory for a hosted organization to enable access to Outlook Web Access (OWA) by typing a URL such as http://mail.consolidatedmessenger.com/litware into a Web browser.
Deletes the virtual directory for a hosted organization.