db_result_t db_set_timeout ( db_wtime_t  msec  ) 

Set the length of time that an operation will wait for a lock to become available.

This ensures that every database operation will eventually return. Most operations will fail if a lock times out.

Parameters:
msec Time in milliseconds. Use a duration of INT_MAX to disable timeouts.
Returns:
On failure, one of the following error codes is set:

The single-user package does not support db_set_timeout or db_get_timeout. In the single-user library, this function will return DB_FAIL with the error code DB_ENOTIMPL.

See also:
get_db_error, clear_db_error, Error Handling


Copyright © 2005-2008 ITTIA®. All rights reserved.