lgo_Attach()

Attach to a communication service.

#include "laygo.h"

LCid    lgo_Attach
    (
        LService    service
    );

lgo_Attach() attaches to a service which was previously opened with lgo_Open() and detached with lgo_Detach().

lgo_Attach() returns a CID exactly as lgo_Open() does. However, the connection may not be in the open state. lgo_State() can be used to determine what state the connection is in.

If successful, lgo_Attach() returns a non-negative connection identifier (CID) which uniquely identifies the connection during subsequent transactions. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• lgo_ERROR_SERVICE_DATABASE_NOT_FOUND
• lgo_ERROR_SERVICE_UNKNOWN
• lgo_ERROR_SERVICE_NOT_AVAILABLE
• lgo_ERROR_OUT_OF_CONNECTIONS
• lgo_ERROR_OUT_OF_MEMORY

lgo_Open()
lgo_Detach()

LCid    cid;

cid = lgo_Attach("PHYS0");