Synopsis:

       handle=adoConnGetHandle(ConnName)

Arguments:

       ConnName - The connection connection name.

Description:   If a connection is opened in public mode and is given a unque name (see adoConnection()), then this function enables other tasks to obtain the connection handle by specifying this unque name as the argument.     For example if task 1 opens a public, named connection like this:

       adoConnection("MyConn",TYPE_PRIVATE);

Another task can obtain the handle to this public connection through:

       handle=adoConnGetHandle("MyConn");

Returns:   Returns the connection handle associated with the given name upon success or ADOERR_INVLDNAME if the name was not found.