lgo_ConnectRequest()

Initiate a request to establish a communication session with a remote system.

#include "laygo.h"

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

lgo_ConnectRequest() initiates a request to establish a communication session with a remote system. The application may either cancel the request by calling lgo_Reopen() or poll for the receipt of a response using lgo_Poll() or lgo_Event().

An unsuccessful return from lgo_ConnectRequest() means that no connection request was initiated.

The contents of the buffer, if any, are defined by the protocol.

If successful, lgo_ConnectRequest() 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_ConnectAccept()
lgo_ConnectReject()

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