dlpreadopendbinfo(3)

NAME

DlpReadOpenDBInfo - read information about a PalmOS database

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>
#include <pconn/pconn.h>
int
DlpReadOpenDBInfo(PConnection  *pconn,  ubyte handle, struct
dlp_opendbinfo *dbinfo);

DESCRIPTION

DlpReadOpenDBInfo reads information about a database on the

Palm.

handle is the database handle given by DlpOpenDB.

dbinfo is filled in with information about the database. The

dlp_opendbinfo structure is trivial:

struct dlp_opendbinfo
{

uword numrecs;

};

where numrecs is the number of records or resources in the

database.

RETURN VALUE

DlpReadOpenDBInfo returns 0 if successful, or a negative

value otherwise.

NOTES

The fact that this function takes an entire structure for a

single value may be considered a bug. However, with a name like

``read open DB info,'' it seems likely that in future versions,

this function might return far more information.

SEE ALSO

libpconn(3), DlpOpenDB(3).

BSD Aug 16, 2001

BSD