beautypg.com

Apple AppleShare 3.0 File Server Controls User Manual

Page 45

background image

scMessagePtr Longword input value: A pointer to a Str199

containing the message sent to the

workstations.

Result Codes noErr 0 No error.

AlreadyShuttingDown -1 The server is already

shutting down.

AlreadyDisconnecting -2 The server is already

disconnecting.

paramErr -50 The server is not running,

scArrayCount is greater than

scMaxVolumes as returned by

SCGetSetupInfo, a volume

reference number is not

valid,scNumMinutes is out of

range,or an unknown bit is

set in scFlags.

SCGetExpFldr

SCGetExpFldr returns information about shared folders and volumes.

Note Macintosh File Sharing does not return fnfErr when there is no shared

volume or folder at a particular index position. Instead, it returns noErr

and takes no other action. To determine if a particular location is in use,

set scVRefNum to zero before calling SCGetExpFldr. If scVRefNum is still zero

after SCGetExpFldr is called, then there is no shared volume or folder at

that particular index position.

!! WARNING SCNamePtr must be NIL when scIndex is negative. Otherwise,

Macintosh File Sharing writes garbage into memory. See the comments in the

sample function code listed under "SCGetExpFldr" in Chapter 1. !!

Parameter (uses standardPB variant of SCParamBlockRec)

Block 16 ioResult word

18 scNamePtr long

22 scVRefNum word

24 scLogins word

26 scCode word

28 scIndex word

30 scDirID long

Fields ioResult Word result value: Result code.

scNamePtr Longword input pointer: Points to a Str13

where the shared folder's AFP short name will be

returned, or must contain NIL. If scIndex is