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. Preferences 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 Saved Preferences. Otherwise, it 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.