dlpwriterecord(3)

NAME

DlpWriteRecord - write a record to a PalmOS device

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>
#include <pconn/pconn.h>
int
DlpWriteRecord(PConnection *pconn, const ubyte handle, const
ubyte flags, const udword id, const ubyte attributes, const ubyte
category, const udword len, const ubyte *data, udword *recid);

DESCRIPTION

DlpWriteRecord writes a record to a database on a Palm. The

database must already be open for writing.

handle is a database handle, as returned by DlpOpenDB(3).

flags specifies flags. There are no useful flags. Set this

argument to 0.

id specifies the record's ID.

attributes specifies the record's attributes. See the

DLPCMD_DBFLAG_* flags in <pconn/dlp_cmd.h>.

category specifies the record's category (but see the BUGS

section).

len specifies the length of data.

data points to the record data.

recid is filled in with the record ID on the Palm. The Palm

may assign the record an ID other than that given by id.

RETURN VALUE

DlpWriteRecord returns 0 if successful, or a negative value

otherwise.

SEE ALSO

libpconn(3), DlpOpenDB(3), DlpWriteResource(3).

BUGS

The category argument might refer to the 8-bit category

identifier, or it might refer to the 4-bit index of the category

identifier in the AppInfo block. I think it's the latter.

BSD Aug 16, 2001

BSD