lgo_DisconnectRequest()

Initiate termination of a communication session established with a remote system.

#include "laygo.h"

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

lgo_DisconnectRequest() initiates an orderly termination of a communication session. The application should poll for completion of the termination using lgo_Poll() or lgo_Event().

An unsuccessful return from lgo_DisconnectRequest() means that no disconnect request was initiated.

If successful, lgo_DisconnectRequest() 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_ConnectRequest()
lgo_DisconnectConfirm()

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