PBHGetLogInInfoSync
PBHGetLogInInfo Get user log in name and method for a shared HFS volume
#include <Files.h> File Manager (PBxxx)
OSErr PBHGetLogInInfo(pb, async ); Boolean async ; 0=await completion; 1=immediate return PBHGetLogInInfo obtains the method for logging in to a volume and the
name of the user during the log in procedure.
pb is the address of a 44-byte ObjParam structure. The following fields are relevant:
Out-In Name Type Size Offset Description
-> ioCompletion ProcPtr 4 12 Completion routine address (if async =TRUE) <- ioResult OSErr 2 16 Error Code (0=no error, 1=not done yet) -> ioVRefNum short 2 22 Volume reference
<- ioObjType short 2 26 Log in method
<- ioObjNamePtr ProcPtr 4 28 Log in name buffer address async is a Boolean value. Use FALSE for normal (synchronous) operation or TRUE to enqueue the request and resume control immediately. See Async I/O.
noErr (0) No error
nsvErr (-35) No such volume
Notes: The ioObjNamePtr is a Pascal string containing the user name, while
ioObjType specifies the log in method, which will be one of: 1= guest; 2 =
registered user with a password in clear text; 3 = registered user with an
encrypted password; 4-127 = reserved values; and 128-255 =
user- defined values. The user name can be up to 31 characters long.