![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_123.png)
21-14
Database Management Tools
Programmer’s Manual
Hint
Current implementation of tool stop searching once an exact match is found.
There is no provision for the case where multiple matches exist.
For good programming practice, user must check the status returned to ensure
a valid search is found before using the record identifier returned.
21.18
DBSecretFlag
Syntax
STATUS
DBSecretFlag
(U32 dbId P_S32 sFlag)
Description
Checks if the secret flag of a particular database is set or not.
Parameter
Return Value
Hint
The database referred to must be a valid object in the PPSM environment.
PPSM_ERROR
Unsuccessful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_DB_RECID
Invalid record identifier
PPSM_ERR_DB_FDID
Invalid field identifier
PPSM_NO_MATCH
No match of data
Name
Description
dbId
Identifier of the database
sFlag
Returns the secret flag of the database. It
can take either of the following two values:
0
Secret flag is cleared
1
Secret flag is set
Name
Description
PPSM_OK
Successful operation
PPSM_ERROR
Unsuccessful operation
PPSM_ERR_DB_DBID
Invalid database identifier
Name
Description
Personal Portable System Manager
Programmer’s Manual
21-11
21.14
DBReadTotalNumberRecords
Syntax
STATUS
DBReadTotalNumberRecords
Description
Reads the total number of records in a given database.
Parameter
Return Value
Hint
The database referred to must be a valid object in the PPSM environment.
21.15
DBReadUnfData
Syntax
STATUS
DBReadUnfData
P_S32 size
,
Description
Reads the data in the unformatted data portion of a record. It will pass back the
pointer to the unformatted data being stored in the record. In addition, it will
also pass back the type
PPSM_ERR_DB_READNO
Invalid number found
Name
Description
dbId
numRec
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_DB_DBID
Invalid database identifier
Name
Description
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.