dlpreaduserinfo(3)

NAME

DlpReadUserInfo, DlpWriteUserInfo - read and write user in

formation to/from a PalmOS device

LIBRARY

libpconn

SYNOPSIS

#include <palm.h>
#include <pconn/pconn.h>
int
DlpReadUserInfo(PConnection   *pconn,   struct  dlp_userinfo
*userinfo);
int
DlpWriteUserInfo(PConnection    *pconn,     const     struct
dlp_setuserinfo *userinfo);

DESCRIPTION

DlpReadUserInfo() reads user information from pconn and

stores it in userinfo. The dlp_userinfo structure is defined in

<pconn/dlp_cmd.h> as

struct dlp_userinfo
{

udword userid;
udword viewerid;
udword lastsyncPC;
struct dlp_time lastgoodsync;
struct dlp_time lastsync;
ubyte usernamelen;
ubyte passwdlen;
char username[DLPCMD_USERNAME_LEN];
ubyte passwd[256];

};

DlpWriteUserInfo() writes user information to the Palm. The

dlp_setuserinfo structure is defined as

struct dlp_setuserinfo
{

udword userid;
udword viewerid;
udword lastsyncPC;
struct dlp_time lastsync;
ubyte modflags;
ubyte usernamelen;
const char *username;

};

The modflags field specifies which fields contain values and

should therefore be uploaded. It should be the bitwise-or of zero

or more of the following:

DLPCMD_MODUIFLAG_USERID
DLPCMD_MODUIFLAG_SYNCPC
DLPCMD_MODUIFLAG_SYNCDATE
DLPCMD_MODUIFLAG_USERNAME
DLPCMD_MODUIFLAG_VIEWERID

RETURN VALUE

DlpReadUserInfo() and DlpWriteUserInfo() return 0 if suc

cessful, or a negative value in case of error.

SEE ALSO

libpconn(3), new_PConnection(3).

BSD Aug 16, 2001

BSD