man DlpReadAppPreference (Fonctions bibliothèques) - DlpReadAppPreference ,

NAME

DlpReadAppPreference ,DlpWriteAppPreference - read/write PalmOS application preference

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>#include <pconn/pconn.h>DlpReadAppPreference PConnection *pconn const udword creator const uword id const uword len const ubyte flags struct dlp_apppref *pref ubyte *dataDlpWriteAppPreference 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 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

CETTE PAGE DOCUMENTE AUSSI :