Daylight v4.9
Release Date: 1 February 2008

Name

dt_release - release an object from a server's retained list

Generic Prototype

dt_release(dt_Handle, dt_String) => dt_Boolean

C Prototype

#include "dt_thor.h"

dt_Boolean dt_release(dt_Handle object, dt_Integer alen, dt_String auth_pw)

FORTRAN Prototype

include 'dt_f_thor.inc'

logical dt_f_release(object, auth_pw)

integer*4 object
character*() auth_pw

Description

Unmarks the specified object as held, so that it will be closed or deleted from the server's memory after the last client closes the object.

The password 'auth_pw' is that of user "thor", and must be supplied even if the client is connected as user "thor". 'object' may be a database or column.

Note that this is an operation to manage the server's use of memory, as opposed to a object operation. Hence the authorization password for user "thor" rather than the database executive password.

Return Value

Returns the success (TRUE) or failure (FALSE) of the operation.

Related Topics

dt_database(3) dt_getdatabases(3) dt_getpasswords(3) dt_getsearchpath(3) dt_getusers(3) dt_hold(3) dt_isheld(3) dt_isopen(3) dt_ispublic(3) dt_open(3) dt_ping(3) dt_server(3) dt_setpassword(3) dt_setsearchpath(3)