Справочник Пользователя для Apple appleshare 3.0

Note  For Apple II users, AppleShare Admin creates a personal folder for each

user inside the Users folder. Thus, even if the Apple2 bit is set, the

Startup menu (in AppleShare Admin) must be used for all Apple II users. (For

more information about the contents of the Users folder, see the AppleShare

Programmer's Guide for the Apple II.)

The following UGLibrary functions are relevant to file servers and are

described in detail later in this document:

- UGGetULInfo

- UGSetULInfo

Using UGLibrary

Four files are provided to allow programs to use the library functions:

- UGLibrary.o contains the object code for all functions and must be linked

with programs that call the library functions.

- UGLibrary.p contains the data structures, function declarations, and error

codes returned by the functions. This file must be included in Pascal

programs.

- UGLibrary.h contains the data structures and function declarations and must

be included in C programs.

- UGLibErrors.h contains the error codes returned by the functions and must

be included in C programs.

All functions are passed two parameters: UserGroupPBPtr, which is used for

passing all the input values for the function and also to pass back the

output values, and async, a Boolean value used to indicate whether the

function is called synchronously or asynchronously. All functions in version

1.0 of UGLibrary must be called synchronously. Calling a function

asynchronously will result in a ugBadParamErr error.

You should be aware of the following restrictions in the use of UGLibrary

version 1.0:

- The UGLibrary functions work only with users and groups files on local

volumes.

- Functions must be called synchronously.

- While the file server or AppleShare Admin program is active, your program

cannot use UGLibrary functions that write to the users and groups file used

by the file server or the AppleShare Admin program. For your program to write

to a users and groups file, either the file server (or AppleShare Admin) must

be shut down, or a copy of the file must be made before the file server (or

AppleShare Admin) is started, so that your program can work with the copy.

!!  IMPORTANT  Use of the UGLibrary functions in any way other than that

described in this document will produce undefined results. You should take

every precaution to avoid corrupting the users and groups file. It is highly

recommended that you make a copy of the users and groups file, and call the

functions only on the copy.  !!