ComRelease

This function releases exclusive access to a previously acquired communication port. This routine should be called prior to ComClose, otherwise, it will be implicitly called. It is not an error if the application has no ownership declared and this call is made.

ComRelease is only strictly necessary if the port was seized with the exclusive ownership mode specified via a ComAcquire call, but application writers are requested to follow a ComAcquire/ComRelease regimen for application consistency.

Note that since the ComAcquire call does not nest, a single ComRelease will "match" any number of ComAcquire calls. ComRelease does not close the communication port, so the handle remains valid.


Syntax:      err_t far ComRelease(handle_t Handle) 
Parameters:  handle_t Handle The handle returned via a successful ComOpen.  
Returns:     E_SUCCESS (0) - Operation successful 
Comments:    ComOpen() must first be called in order to get a valid handle to the 
             communications port.