lgo_GetStatus()

Retrieve a status report for a connection.

#include "laygo.h"

LResult lgo_GetStatus
    (
        LCid           cid,
        LCtlBuffer     buffer,
        LBufferSize    size
    );

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_ERROR_INVALID_CID
• lgo_ERROR_INVALID_COMMAND
• lgo_ERROR_INVALID_OUTPUT_BUFFER
• lgo_ERROR_BUFFER_SIZE

lgo_GetStatistics()

lgo_GetStatus(cid, buffer, bufCapacity);