Platform SDK: Exchange Server |
The BEXPORT_PARMS structure contains information for the BatchExport function.
Header file: | DAPI.H |
Unicode: | Yes |
typedef struct { DWORD dwDAPISignature; DWORD dwFlags; HWND hwndParent; LPTSTR pszExportFile; UINT uCodePage; LPTSTR pszDSAName; LPTSTR pszBasePoint; LPTSTR pszContainer; TCHAR chColSep; TCHAR chQuote; TCHAR chMVSep; TCHAR cReserved; CALLBACKPROGRESS ProgressCallBacks; ERROR_CALLBACK ErrorCallback; EXPORT_CALLBACK ExportCallback; PDAPI_ENTRY pAttributes; LPTSTR pszHomeServer; LPTSTR * rgpszClasses; ULONG ulUSNBase; LPVOID pReserved; } BEXPORT_PARMS, *PBEXPORT_PARMS, *LPBEXPORT_PARMS;
If this member is DAPI_UNICODE_FILE (which specifies that the DIT object is in Unicode format), but the DIT object is in ANSI format, BatchExport fails and emits a diagnostic error message in the Windows NT Application event log.
BatchExport also fails and emits a diagnostic error message in the Windows NT Application event log if this member is a format other than DAPI_UNICODE_FILE or 0 (zero, which is autodetect) and either of the following conditions is true:
If this member is NULL, BatchExport searches for a DSA in the following order:
Use MAPI function calls to determine the DSA. See the MAPI Programmer's Reference for more information.
If this member is NULL, the basepoint is the current site object where the DSA resides (as specified by the lpBexportParms->pszDSAName parameter member); if lpBexportParms->pszBasePoint is "" (an empty string), the basepoint is the current organization object. The basepoint is the point in the DIT where BatchExport performs its bulk object creation or bulk object manipulation operations.
If this member is NULL, BatchExport exports the contents of all containers below the point specified by the pszBasePoint member.
If this member is NULL, BatchExport uses the default separator, which is defined as DEFAULT_DELIM (see DAPI.H).
The default column separator used by the directory functions is unrelated to the default column separator specified within the Administrator program.
If this member is NULL, BatchExport uses the default string enclosure character, which is defined as DEFAULT_QUOTE (see DAPI.H).
If this member is NULL, BatchExport uses the default multivalue separator character, which is defined as DEFAULT_MV_SEP (see DAPI.H).
If this member is NULL, BatchExport displays a default modeless dialog to show progress.
If this member is NULL, BatchExport calls the default error handler, which displays an error dialog window and writes the error into the Windows NT Application event log.
If this member is NULL, BatchExport writes to the file specified by the pszExportFile parameter member.
If you specify export attributes in this member, the first attribute in pAttributes must be NM_OBJECT_CLASS; otherwise, BatchExport fails.
Normally, BatchExport does not export deleted objects. You can export directory objects that are deleted, but not purged, by including the NM_IS_DELETED attribute.
The pAttributes member is required if the ExportCallback member is specified; it is optional if the pszExportFile member is specified.
This member specifies that the mailboxes from only the specified server are exported. If pszHomeServer is NULL, BatchExport exports the mailboxes from all servers.
BatchExport queries the directory for objects of the specified classes in the order that you specify the classes in this member.
BatchExport exports only objects with USN-Changed greater than or equal to this member when EXPORT_USE_USN_BASE is set.
For additional information on this structure, see Exporting Objects.