beautypg.com

Apple AppleShare 3.0 File Server Controls User Manual

Page 55

background image

SCSendMessage

SCSendMessage sends a server message to every user whose user name record ID

(UNRecID) is contained in the array pointed to by scDiscArrayPtr.

Note This call is not supported by Macintosh File Sharing.

Parameter (uses disconnectPB variant of SCParamBlockRec)

Block 16 ioResult word

18 scDiscArrayPtr long

22 scArrayCount word

26 scCode word

30 scFlags word

32 scMessagePtr long

Fields ioResult Word result value: Result code.

scDiscArrayPtr Longword input pointer: Points to the

array of user name record IDs (UNRecID).

scArrayCount Word input value: The number of elements

in the array of user name record IDs

(UNRecID).

scCode Word input value: The server control

code; always SCSendMessage ($0009).

scFlags Word input value: The following bit

must be set:

bUNRFSendMsg There is a message pointed to by

scMessagePtr.

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 or a UNRecID

is invalid.

SCServerVersion

SCServerVersion returns the server version information.