This function creates and opens a new data store. The name of the new data store is specified by the input parameter DbName. The record schema for the data store is specified in the DBInfo structure. The newly created data store is opened under the specified access mode. If user authentication credentials are required, they must be provided. Also, additional open parameters may be required and are supplied in the OpenParameters.

CSSM_DB_HANDLE CSSMAPI CSSM_DL_DbCreate
                 (CSSM_DL_HANDLE DLHandle,
                 const char *DbName,
                 const CSSM_DBINFO_PTR DBInfo,
                 const CSSM_DB_ACCESS_TYPE_PTR AccessRequest,
                 const CSSM_USER_AUTHENTICATION_PTR UserAuthentication,
                 const void *OpenParameters)

Input

DLHandle

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

DbName

The general, external name for the new data store.

DBInfo

A pointer to a structure describing the format/schema of each record type that will be stored in the new data store.

AccessRequest

An indicator of the requested access mode for the data store, such as read-only or read/write.

Input/optional

UserAuthentication

The caller's credential as required for obtaining access to the data store. If no credentials are required for the specified data store, then user authentication must be NULL.

OpenParameters

A pointer to a module-specific set of parameters required to open the data store.

The handle the newly created and open data store. When NULL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.