lgo_ListenCancel()

Cancel a listen request.

#include "laygo.h"

LResult lgo_ListenCancel
    (
        LCid    cid
    );

lgo_ListenCancel() cancels a listen request and returns the connection to the open state. The application may then call either lgo_ConnectRequest() or lgo_Listen() on the CID to attempt to establish a new communication session.

If lgo_ListenCancel() returns lgo_ERROR_EVENT_WAITING, the application should deal with the event from the remote system in the usual way.

If successful, lgo_ListenCancel() 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_TRANSMISSION_BLOCKED
• lgo_ERROR_NO_SYSTEM_BUFFER
• lgo_ERROR_EVENT_WAITING

lgo_Listen()

if (lgo_ListenCancel(cid) < 0)
{
     return (FAILURE);
}