Apple AppleShare 3.0 Users and Groups Programming Interf Manual do Utilizador

USERS AND GROUPS PROGRAMMING INTERFACEUGLibrary is a set of functions that lets you implement users and groupscapabilities for your shared application

(user ID 1) cannot be deleted.Result CodesnoErr 0 No error.ugUserNotFound 5 User is not in the users and

ugGroupAlreadyExists 2 Group with the same name exists.ugUserNotFound 5 The user is not in the users andgroups file.

66 ugGroups 168 bytes array of group IDs(42 longs)UGGetUserInfo can be used to provide information about a specific user,enumerate all users in

ugUserNotFound 5 The user is not in the users and groupsfile.ugGroupNotFound 6 The group is not in the users and grou

Result CodesnoErr 0 No error.ugUserNotFound 5 The user is not in the users and groupsfile.ugNotAUser

ugBadParamErr 13 async is TRUE, the length of the passwordis greater than 8, or the length of theuser name is greater than 31.ugInv

FUNCTION UGDeleteGroup (thePB: UserGroupPBPtr; async: BOOLEAN): OSErr;pascal OSErr UGDeleteGroup (UserGroupPBPtr thePB, Boolean async);Parameter Block

should be a pointer to a zero-length Str31. If ugNamePtr is used, thenugGroupID should be 0. If both fields have values, then ugGroupID takesprecedenc

When UGGetGroupInfo is used to get information about a specific group, thegroup is specified either by ugGroupID or by ugNamePtr. If ugGroupID is used

group. (The primary group is used by AppleShare File Servers 2.0.1 and 3.0when Apple II mode is on. Refer to "Data Structures," later in thi

- UGOpenFile- UGCloseFile- UGCreateFileUsersThe following attributes are assigned to each user (except the guest user): auser ID, a user name, a passw

Result CodesnoErr 0 No error.ugUserNotFound 5 The user is not in the users andgroups file.ugGro

62 ugPwdExpDate long days beforepasswords expireUGGetULInfo returns the characteristics of the AppleShare File Server 3.0 orthe Macintosh File

60 ugMaxBadLogins word maximum failed loginattempts62 ugPwdExpDate long days before userpasswords expireUGSetULInfo sets the fil

BitUser flag number DescriptionIACEnabled 0 Set if IAC is enabled for this user.LoginEnabled

Data File, the state of the reserved bits should be preserved.The following figure shows the ugSrvrFlags bits.All of the ugSrvrFlags flags are effecti

ugCmdAddr: Ptr;ugCompletion: ProcPtr;ugResult: OSErr;ugNamePtr: StringPtr;ugVRefNum: INTEGER;ugRefNum: INTEGER;ugDirID: LONGINT;ugAccessID: LONGINT;ug

ugNamePtr: StringPtr;ugVRefNum: INTEGER;ugRefNum: INTEGER;ugDirID: LONGINT;ugAccessID: LONGINT;ugUserID: LONGINT;ugGroupID: LONGINT;ugPosOffset: INTEG

ugSrvrFlags: ARRAY[0..1] OF LONGINT;ugMinPwdLen: SignedByte;filler1: SignedByte;ugMaxBadLogins: INTEGER;ugPwdExpDate: LONGINT;END;UserGroupPBPtr = ^UG

struct UGFilePBUGPBHeaderStringPtr ugAdminKey;typedef struct UGFilePB UGFilePB;struct UGUserPBUGPBHeadershort ugPosOffset;StringPtr ug

short ugMaxBadLogins;long ugPwdExpDate;typedef struct UGServerPB UGServerPB;union UGParamBlockRecUGFilePB ugFilePB;UGUserPB ugU

parts of the system use the same administrator name. Once the administratoruser is created, it cannot be deleted or renamed by means of UGLibrary; itc

In C:pascal OSErr UGNewUser (UserGroupPBPtr thePB, Boolean async);pascal OSErr UGDeleteUser (UserGroupPBPtr thePB, Boolean async);pascal OSErr UGRenam

pascal OSErr UGGetULInfo (UserGroupPBPtr thePB, Boolean async);pascal OSErr UGSetULInfo (UserGroupPBPtr thePB, Boolean async);Result codes returned by

ugFatalError = 99For more informationAPDA offers convenient worldwide access to over three hundred developmenttools, resources, and training

- UGNewGroup- UGDeleteGroup- UGRenameGroup- UGGetGroupInfo- UGAssignUserToGroup- UGDeleteUserFromGroupThe file serverThe UGGetULInfo function is used

Note For Apple II users, AppleShare Admin creates a personal folder for eachuser inside the Users folder. Thus, even if the Apple2 bit is set, theSta

Macintosh File Sharing supports a combined total of 100 users and groups.Several features supported by the AppleShare File Server 3.0 are notavailable

to a Str31) within the folder specified in ugDirID on the volume specifiedin ugVRefNum. If ugNamePtr points to a zero-length Str31, the localized name

UGCreateFileFUNCTION UGCreateFile (thePB: UserGroupPBPtr; async: BOOLEAN): OSErr;pascal OSErr UGCreateFile (UserGroupPBPtr thePB, Boolean async);Param

UGNewUser creates a new user. The pointer ugNamePtr (a pointer to a Str31)contains the name of the user and the pointer ugPassword (a pointer to aStr8