DlpReadDBList(3)

NAME

DlpReadDBList – get information about databases on a PalmOS device

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>

#include <pconn/pconn.h>

int

DlpReadDBList(PConnection *pconn, const ubyte iflags, const int card, const uword start, uword *last_index, ubyte *oflags, ubyte *num, struct dlp_dbinfo *dbs);

DESCRIPTION

DlpReadDBList reads information about databases on the Palm.

card specifies the number of the memory card on which to look. Card numbers begin at 0.

iflags specifies which databases to retrieve. It is the bitwise-or of one or more of the following:

DLPCMD_READDBLFLAG_RAM: RAM databases
DLPCMD_READDBLFLAG_ROM: ROM (read-only) databases
DLPCMD_READDBLFLAG_MULT: Return multiple database entries (available as of DLP v1.2).

start specifies the number of the first database to read.

last_index is filled in with the index of the last database read.

oflags is filled in with output flags. The only one defined is

DLPRET_READDBLFLAG_MORE: There are more databases after these.

dbs is filled in with descriptions of the databases.

RETURN VALUE

BUGS