Synopsis:

       adoConnParmSet(handle,parmID,Value)

Arguments:

       handle - The connection handle.

       parmID        - The parameter ID to set

       Value        - The value to set the parameter to

Description:   This function enables the underlying connection parameters to be set for the connection defined by handle.     The parmID argument is the ID of the parameter that is to be set (see adoConnParmGet()) and the Value is the value to set it to.    Note that this function can be used at any time after the connection object has been created by a call to adoConnection() and can be used to set up the properties of the connection prior to calling the adoConnOpen() function call.

Important Note: Upon creating the underlying _Connection object the CusorLocation property is hard-coded to to adUseClient.     This is necessary in order for the libary to work in asyncronous (non-blocking) mode.         If you attempt to change the CusorLocation to adUseServer in the adoConnParmSet() function then this could cause some of the ado functions to work syncronously, thus blocking the Telecom Engine task scheduler and seriously effecting performance.     If you need to use server side cursors for any reason then it is suggested that you carefully trace all function calls to check that they don't block for significant periods of time (see Performance and blocking calls) and, if necesary, consider using a client-server model based on the CXSOCKETS.DLL library instead.

Returns:   Returns 0 upon success or a negative error code.   If ADOERR_COMERR is returned, then the underlying ADO error can be obtained by calling adoLastError()