![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_119.png)
21-6
Database Management Tools
Programmer’s Manual
Hint
The record and database referred to must be valid objects in the PPSM
environment.
Observes the unformatted data type specification for interchangeability.
21.7
DBDelete
Syntax
STATUS
DBDelete
(U32 dbId)
Description
Removes a database from PPSM, and frees up all associated memory.
Parameter
Return Value
Hint
The database referred to must be a valid object in the PPSM environment.
21.8
DBDeleteRecord
Syntax
STATUS
DBDeleteRecord
(U32 dbId U32 recId)
Description
Removes a particular record from the specified database, and frees uReturn value
associated memory.
PPSM_ERR_DB_TYPE
Invalid data type
Name
Description
dbId
Identifier of the database to be removed
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_DB_DBID
Invalid database identifier
Name
Description
Personal Portable System Manager
Programmer’s Manual
21-3
Return value
Hint
This tool is meant to facilitate the implementation of insertion operation for an
ordered record list.
For DBAddRecToTop() to work, the reference database ID must have been
created by calling DBAdd() prior to the calling of DBAddRecToTop(). Also, the
recIDpassed must be a valid record ID in the database to be operated on.
21.4
DBAppendRecord
Syntax
STATUS
DBAppendRecord
outRecId
Description
Appends a blank record to the record identified by the given
the record identifier, outRecId, corresponding to the new record. User has the
option to specify additional formatted data fields to be allocated. The valid
range of numFmtis from 0 to 5.
and output
Parameter
Name
Description
PPSM_OK
Successful operation
PPSM_ERROR
Unsuccessful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_NUM_FMT
Invalid user format field number
Name
Description
dbId
recId
numFmt
outRecId
Name
Description
PPSM_OK
Successful operation
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.