Backup and Restore
The Exchange Storage Engine (ESE) implements and controls the storage groups in Microsoft® Exchange Server 2003. ESE provides an application programming interface (API) for creating backup and restore applications. The topics in this section describe the API implemented in the esebcli2.dll library.
Backup and Restore applications using the esebcli2 interface can operate locally on the Exchange server, or remotely via remote procedure call (RPC).
The esebcli2 interface provides coordinated backup and restore for Exchange Server 2003 storage groups and databases. Databases backed up using this API can handle log file truncation properly. Databases restored using this API can apply the restored logs to bring the database up-to-date properly.
The following are general guidelines and notes about using the esebcli2 backup and restore API.
For overview information that describes backup and restore operations, options, and sequencing, see Backup and Restore.
Non-Dual DLL Interface
The esebcli2.dll is a non-dual dynamic-link library (DLL). For this reason, C/C++ must be used to access the backup and restore functions. Use the Microsoft® Windows® LoadLibrary function to load the DLL.
Backup and Restore Privileges Required
Applications that use the esebcli2 interface must be run under a user account that has Microsoft Windows® server operating systems Backup and Restore privileges.
Remote and Local Operation Supported
The API provided by esebcli2 supports connecting to ESE on the local computer, or on a different computer. Remote connections are made using standard RPC.
Multiple ESE Instances Available for Restore
Exchange Server 2003 supports up to four simultaneously-mounted storage groups per server. Each storage group is handled by a separate instance of ESE. However, ESE supports up to 16 simultaneously-running instances. The 12 extra ESE instances can be used to create parallel data streams, for potentially improved restore performance. But the extra ESE instances cannot be used for backup. When using multiple instances to restore a storage group, remember that the databases can be recovered only after all of the necessary database, log, and patch files have been restored fully to disk.
Use Only Fully Qualified Folder and File Names
All file names passed to, and returned by, the backup and restore functions must include the drive, folder, file name, and extension.
Double-Byte Character System (DBCS) Cannot be Used in Folder and File Names
The backup and restore API does not support using double-byte character set (DBCS) characters in file names or in folder paths. However, DBCS is supported in parameters that are intended for display names.
Multiple-Section Operations Not Supported
Some functions in the esebcli2 API accept or return arrays of file handles. However, in all cases, those arrays can contain only one file handle. So-called "multiple-section" operations are not supported. In those functions that accept number of sections as an input parameter, the parameter must always be 1.
During setup, Exchange Server 2003 places the file esebcli2.doc in the SDK\Support\Backup folder under the Exchange installation folder. This documentation is obsolete, and inaccurate in some areas. To access the most up-to-date information, see Microsoft Exchange Server on MSDN.
This reference section contains information about the following: