This function exports a copy of the data store records from the source data store to a data container that can be used as the input data source for the CSSM_DL_DbImport function. The DL module may require additional user authentication to determine whether the user is authorized to create a copy of an existing data store.

CSSM_RETURN CSSMAPI CSSM_DL_DbExport 
                     (CSSM_DL_HANDLE DLHandle,
                     const char *DbDestinationName,
                     const char *DbSourceName,
                     CSSM_BOOL InfoOnly,
                     const CSSM_USER_AUTHENTICATION_PTR UserAuthentication)

Input

DLHandle

The handle that describes the DL module to be used to perform this function.

DbSourceName

The name of the data store from which the records are to be exported.

DbDestinationName

The name of the destination data container that will contain a copy of the source data store's records.

InfoOnly

A Boolean value indicating what to export. If CSSM_TRUE, export only the DBInfo, which describes the data store. If CSSM_FALSE, export both the DBInfo and all of the records in the specified data store.

Input/optional

UserAuthentication

The caller's credentials as required for authorization to copy a data store. If the DL module requires no additional credentials to perform this operation, then user authentication can be NULL.

A CSSM_OK return value signifies that the function completed successfully. When CSSM_FAIL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.

CSSM_DL_DbImport