dlpreadapppreference(3)

NAME

DlpReadAppPreference, DlpWriteAppPreference - read/write

PalmOS application preference

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>
#include <pconn/pconn.h>
int
DlpReadAppPreference(PConnection    *pconn,   const   udword
creator, const uword id, const  uword  len,  const  ubyte  flags,
struct dlp_apppref *pref, ubyte *data);
int
DlpWriteAppPreference(PConnection   *pconn,   const   udword
creator,  const  uword  id,  const  ubyte  flags,  const   struct
dlp_apppref *pref, const ubyte *data);

DESCRIPTION

Palm applications have preferences associated with them.

These are typically user options. The Mail application also

stores the signature for outgoing messages in a preference. Pref

erences are stored in the Saved Preferences and Unsaved

Preferences resource databases.

DlpReadAppPreference reads an application preference from

the Palm.

creator specifies the four-letter application identifier.

id specifies the preference ID.

len specifies the maximum number of bytes to return in data.

flags specifies flags: if DLPC_READAPPFL_BACKEDUP is set,

DlpReadAppPreference

reads from Unsaved Preferences.
pref is filled in with information about the preference. The

dlp_apppref structure is defined as

struct dlp_apppref
{

uword version;
uword size;
uword len;

};

where size gives the actual size of the preference, and len

gives the number of bytes returned in data. It is not clear what

version is.

data is filled in with the preference data.

DlpWriteAppPreference writes an application preference to

the Palm. The arguments are similar to those for

DlpReadAppPreference

RETURN VALUE

These functions return 0 if successful, or a negative value

otherwise.

SEE ALSO

libpconn(3), new_PConnection(3).

BSD Aug 16, 2001

BSD