
21-4
Database Management Tools
Programmer’s Manual
Hint
This tool is meant to facilitate the implementation of insertion operation for an
ordered record list.
For DBAppendRecord() to work, the reference database ID must have been
created by calling DBAdd() prior to the calling of DBAppendRecord(). Also, the
recIDpassed must be a valid record ID in the database to be operated on.
21.5
DBChangeStdData
Syntax
STATUS
DBChangeStdData
(U32 dbId U32 recId, S32 fieldId P_TEXT Syntax
Description
Changes the data in a predefined standard field of a record in the specified
database.
Parameter
PPSM_ERROR
Unsuccessful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_DB_RECID
Invalid record identifier
PPSM_ERR_NUM_FMT
Invalid user format field number
Name
Description
dbId
Identifier of the database
recId
Identifier of the record
fieldId
Identifier of the field:
DB_LAST
DB_FIRST
DB_HOME
DB_OFFICE Office Phone
DB_ADDRESS
Last Name
First Name
Home Phone
Address
Fax
DB_FAX
DB_COMPANY
Company
Additional fields
1, 2, 3, 4, 5
data
Data to be put into the field
Name
Description
Personal Portable System Manager
Programmer’s Manual
21-5
Return Value
Hint
Adheres to the size limit of each data field when writing data into it.
The record and database referred to must be valid objects in the PPSM
environment.
21.6
DBChangeUnfData
STATUS
DBChangeUnfData
S32 size
,
Description
Changes the datain the unformatted data portion of a record.
Parameter
Return Value
Name
Description
PPSM_OK
Successful operation
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
Name
Description
dbId
recId
type
data
data
size
Name
Description
PPSM_OK
Successful operation
PPSM_ERROR
Unsuccessful operation
PPSM_ERR_DB_DBID
Invalid database identifier
PPSM_ERR_DB_RECID
Invalid record identifier
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.