Daylight v4.9
Release Date: 1 February 2008

Name

dt_getusers - get the current list of users of an object

Generic Prototype

dt_getusers(dt_Handle) => dt_Handle

C Prototype

#include "dt_thor.h"

dt_Handle dt_getusers(dt_Handle object)

FORTRAN Prototype

include 'dt_f_thor.inc'

integer*4 dt_f_getusers(object)

integer*4 object

Description

Gets 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 Value

Returns a sequence of strings. For objects other than servers and databases, this property is defined as NULL_OB.

Related Topics

dt_database(3) dt_evict(3) dt_getdatabases(3) dt_getsearchpath(3) dt_ping(3) dt_server(3) dt_setsearchpath(3)