This function deletes all records from the specified data store and removes all state information associated with that data store.

CSSM_RETURN CSSMAPI CSSM_DL_DbDelete
               (CSSM_DL_HANDLE DLHandle,
               const char *DbName,
               const CSSM_USER_AUTHENTICATION_PTR UserAuthentication)

Input

DLHandle

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

DbName

A pointer to the string containing the logical name of the data store.

Input/optional

UserAuthentication

The caller's credentials as required for obtaining access (and consequently deletion capability) to the data store. If no credentials are required for the specified data store, then user authentication must 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.