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