![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_121.png)
21-10
Database Management Tools
Programmer’s Manual
Parameter
Return Value
Hint
The database and record referred to must be valid objects in the PPSM
environment. If a user defined field is to be read, it is the use
r’s responsiSyntax
to check the return status for PPSM_OK, to ensure that the user defined field
does exist before using the returned
data
for subsequent processing.
21.13
DBReadTotalNumber
Syntax
STATUS
DBReadTotalNumber
(P_S32
numDB
)
Description
Reads the total number of databases in the PPSM environment.
Parameter
Return Value
Name
Description
dbId
Identifier of the database
recId
Identifier of the record
fieldId
Identifier of the field
data
Returns the pointer to the starting address
of the data
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_DB_RECID
Invalid record identifier
PPSM_ERR_DB_FDID
Invalid field identifier
Name
Description
numDB
Returns the total number of databases
Name
Description
PPSM_OK
Successful operation
Personal Portable System Manager
Programmer’s Manual
21-7
Parameter
Return Value
Hint
The database and record referred to must be valid objects in the PPSM
environment.
21.9
DBGetFirstRecID
STATUS
DBGetFirstRecID
Description
Gets the record ID of the first record in the record list of the given database.
Parameter
Return Value
Hint
Name
Description
dbId
recId
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_DB_RECID
Invalid record identifier
Name
Description
dbId
recId
Name
Description
PPSM_OK
Successful operation
PPSM_ERROR
Unsuccessful operation
PPSM_ERR_DB_DBID
Invalid database identifier
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.