DlpReadUserInfo(3)

NAME
DlpReadUserInfo, DlpWriteUserInfo - read and write user information 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 successful, or a negative value in case of error.

SEE ALSO
libpconn(3), new_PConnection(3).