man DlpWriteRecord (Fonctions bibliothèques) - DlpWriteRecord

NAME

DlpWriteRecord - write a record to a PalmOS device

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>#include <pconn/pconn.h>PConnection *pconnconst ubyte handleconst ubyte flagsconst udword idconst ubyte attributesconst ubyte categoryconst udword lenconst ubyte *dataudword *recid

DESCRIPTION

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 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

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.