lgo_ResetRequest()

Initiate a reset procedure on a connection.

#include "laygo.h"

LResult lgo_ResetRequest
    (
        LCid           cid,
        LCtlBuffer     buffer,
        LBufferSize    count
    );

lgo_ResetRequest() initiates a protocol reset of a connection with remote system.

lgo_ResetRequest() is a valid command only in states data transfer xon and data transfer xoff. If the reset action completes successfully, the connection returns to data transfer xon state.

If successful, lgo_ResetRequest() returns a non-negative value. 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_INPUT_BUFFER
• lgo_ERROR_TRANSMISSION_BLOCKED
• lgo_ERROR_NO_SYSTEM_BUFFER

lgo_Event()
lgo_Poll()

if (lgo_ResetRequest(cid, NULL, 0) < 0)
{
    return (FAILURE);
}