lgo_GetStatus()
Retrieve a status report for a connection.
#include "laygo.h" LResult lgo_GetStatus ( LCid cid, LCtlBuffer buffer, LBufferSize size );
cid | connection to retrieve status report on |
buffer | buffer to hold retrieved status report |
size | size of buffer |
lgo_GetStatus() retrieves the status report for
a connection. If the call to lgo_GetStatus() is successful,
the contents of the control buffer passed to the function may
be cast to type LStatusReport
as defined in laygodef.h.
If successful, lgo_GetStatus() returns a non-negative value indicating the number of bytes returned into the buffer. A return value of 0 means that no status report for the connection is available. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:
lgo_GetStatus(cid, buffer, bufCapacity);