ASPGetStatus
ASPGetStatus Get server status
#include <AppleTalk.h> AppleTalk Manager
OSErr ASPGetStatus( xParamBlock, async);
XPPParmBlkPtr xParamBlock; pointer to an AppleTalk parameter block
Boolean async; 0=await completion; 1=immediate return
returns Error Code; 0=no error
ASPGetStatus returns server status.This call is also used as GetServerInfo
at the AFP level. This call is unique in that it transfers data over the network
without having a session open. This call does not pass any data but requests that
server status be returned.
xParamBlock is a pointer to a parameter block structure. The relevant fields are
as follows:
Out-InName Type Size Offset Description
¨ csCode short 2 26 AlwaysASPGetStatus
¨ aspTimeout char 1 30 Retry interval in seconds
¨ aspRetry char 1 31 Number of retries
¨ serverAddr short 2 32 Server socket address
´ rbSize short 2 38 Reply buffer and reply size
¨ rbPtr Ptr 4 40 Reply buffer pointer
¨ ccbStart record 150 50 Start of memory for CCB
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.
Returns: an operating system Error Code.
aspBufTooSmall (-1067) Reply is bigger than response buffer; the buffer will
be filled, data will be truncated
aspNoServer (-1069) No response from server at address used in call

Notes: ASPTimeOut is the interval in seconds between retries of the call.
ASPRetry is the number of retries that will be attempted.
ServerAddr is the network identifier or address of the socket on which the
server is listening.
RBSize is passed and indicates the size of the reply buffer in bytes expected
by the command. RBSize is also returned and indicates the size of the reply
that was actually returned.
RBPtr points to the reply buffer.
CCBStart is the start of the memory to be used by the .XPP driver for the
command control block. The size of this block is equal to a maximum of 150
bytes.