The directory access functions combine and automate several maintenance tasks. For example, with a single call, you can create a mailbox object, create and associate a Windows NT account and associate the mailbox object to it, add proxy addresses, assign user privileges, add the mailbox to distribution lists, and set its other attributes.
Several groups of functions and structures are often used together to perform a single task or a group of tasks. These sets of functions and structures are listed in the following tables, grouped by functionality type.
Functions for Exporting Directory Information
| Operation | Purpose | Functions and Structures |
|---|---|---|
| Batch export | Exports objects from the directory. Exported data is defined by members of the BEXPORT_PARMS structure. | BEXPORT_PARMS BatchExport DAPI_FNErrorCallback DAPI_FNExportEntry |
| Line export | Exports individual objects from the directory. | DAPIStart DAPIRead DAPIEnd |
| Get configuration information | Returns configuration information about the site associated with the active server. | SITE_INFO DAPIGetSiteInfo |
Functions for Importing Directory Information
| Operation | Purpose | Functions and Structures |
|---|---|---|
| Batch import |
Imports objects specified in an import file into the directory. | BIMPORT_PARMS BatchImport |
| Line import | Imports individual objects supplied by the caller into the directory. | DAPIStart DAPIWrite DAPIEnd |
Functions for Extracting Windows NT Server User Accounts
| Operation | Purpose | Functions and Structures |
|---|---|---|
| Windows NT Server export interface |
Exports multiple objects to an import file by reading a list of users from a Windows NT Server database. The resulting import file can then be used by batch import. | NTEXPORT_PARMS NTExport |
Functions for Extracting Novell NetWare User Accounts
| Operation | Purpose | Functions and Structures |
|---|---|---|
| Novell NetWare export interface |
Exports multiple objects to an import file by reading a list of users from a NetWare server. The resulting import file can then be used by batch import. | NWEXPORT_PARMS NWExport |
Functions for Performing Administrative Tasks
| Operation | Purpose | Functions and Structures |
|---|---|---|
| Progress display | Controls display of the progress of an ongoing operation. | CALLBACKPROGRESS EndProgressProc InitProgressProc ResetProgressProc UpdateProgressProc UpdateProgressTextProc |
| Error handling | Controls the interpretation, display, and handling of error events. | DAPI_EVENT |
| Preinitialization | Loads the directory schema in a background process. If, for example, your application needs to gather information from the user, this function allows you to load the schema as a background process while the user is typing, so that processing can begin as soon as the user is finished. | SchemaPreload |