Release Date: 1 February 2008
Namedt_getusers - get the current list of users of an object
Generic Prototypedt_getusers(dt_Handle) => dt_Handle
C Prototype#include "dt_thor.h"
dt_Handle dt_getusers(dt_Handle object)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
DescriptionGets the current list of users of the object as a sequence of string objects. Each string object contains the name of a currently connected user and, when 'object' is a server, the number of connections that user has. (eg. "cjames@crawdad 3" may be one string returned in the sequence).
When 'object' is a database, the name of the user is followed by the permission with which the user has the database opened. (eg. "cjames@crawdad r"). When 'object' is a database, multiple connections will be listed separately.
The calling application is responsible for deallocating the strings and sequence (the strings are not automatically deallocated when the sequence is deallocated).
Return ValueReturns a sequence of strings. For objects other than servers and databases, this property is defined as NULL_OB.
Related Topicsdt_database(3) dt_evict(3) dt_getdatabases(3) dt_getsearchpath(3) dt_ping(3) dt_server(3) dt_setsearchpath(3)