SchemaPreload

The SchemaPreload function initializes the attribute and class tables for import and export operations. Microsoft Exchange Server executes the SchemaPreload function in the background as a separate thread.

Quick Info

Header file: DAPI.H
Library: DAPI.LIB
Unicode: Yes

VOID SchemaPreload(
  DWORD dwFlags, 
  LPTSTR pszDSA  
);
 

Parameters

dwFlag
Accepts defined values that control the directory schema operations. Use the bitwise OR operator (|) to enable multiple operations:
DAPI_FORCE_SCHEMA_LOAD
Unloads a previously loaded schema and reads the schema again. The default action is to reuse the previously loaded schema if read from the same messaging domain.
DAPI_RAW_MODE
Imports and exports in raw mode, where import lines are taken literally. Attributes are neither inherited nor constructed, and aliases for attribute and class names are not recognized.
Flags That Control Event Filtering:
DAPI_EVENT_MIN
Logs start and stop messages. Provides no warning or error logging.
DAPI_EVENT_SOME
Logs Start, Stop, and Error messages.
DAPI_EVENT_ALL
Logs Start, Stop, Error, and Warning messages.
pszDSA
The name of the directory service agent where the schema is read.

Return Values

None.

Remarks

The SchemaPreload function is optional. It allows an image of the directory schema to be loaded by a separate Windows NT Server thread while the directory access process is being initialized. For example, your program can load the schema while a user is entering import or export parameters in a dialog.

Microsoft Exchange Server uses the schema that was loaded into the schema cache for all subsequent directory access operations, until one of the following events occurs:

For more information on this function, see Using Directory Access Functions.

See Also

BatchExport, BatchImport, DAPIRead, DAPIWrite