dlpreadappblock(3)

NAME

DlpReadAppBlock, DlpWriteAppBlock, DlpReadSortBlock,

DlpWriteSortBlock

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>
#include <pconn/pconn.h>
int
DlpReadAppBlock(PConnection   *pconn,  const  ubyte  handle,
const uword offset, const uword len,  uword  *size,  const  ubyte
**data);
int
DlpWriteAppBlock(PConnection  *pconn,  const  ubyte  handle,
const uword len, const ubyte *data);
int
DlpReadSortBlock(PConnection  *pconn,  const  ubyte  handle,
const  uword  offset,  const  uword len, uword *size, const ubyte
**data);
int
DlpWriteSortBlock(PConnection *pconn,  const  ubyte  handle,
const uword len, const ubyte *data);

DESCRIPTION

DlpReadAppBlock reads the AppInfo block of a database on the

Palm. The database must already be open for reading.

handle is the database handle given by DlpOpenDB.

offset indicates the offset at which to start reading. This

should be 0 to read from the beginning of the AppInfo block.

len indicates the maximum number of bytes to read.

size is filled in with the number of bytes actually read.

data is filled in with a pointer to a buffer containing the

data read. This buffer is volatile, so the data should be copied

before the next DLP function call.

DlpWriteAppBlock writes a database's AppInfo block. If the

database already had an AppInfo block, it is erased.

handle is the database handle given by DlpOpenDB.

len specifies the length of the new AppInfo block.

data is a pointer to the new AppInfo block.

DlpReadSortBlock and DlpWriteSortBlock are similar to

DlpReadAppBlock

sort block instead of its AppInfo block.

RETURN VALUE SEE ALSO

libpconn(3), DlpOpenDB.

BSD Aug 16, 2001

BSD