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.