DLFINDN C-3





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


dlfindn - get nth logical RMSfile description

SYNOPSIS


#include 

LF *dlfindn (dbname, n)
char *dbname;
int n;

DESCRIPTION


Dlfindn searches the C/Base database catalog for the nth logical
RMSfile defined in the given database. If found, a pointer to a
structure describing the logical RMSfile is returned. If the
given database contains fewer than n entries, a NULL pointer is
returned and the RMS error message is set describing the reason
for not finding the logical RMSfile entry.

Dbname is the name of the database. If dbname is a NULL pointer
or an empty string, the default database name is used.

The order of logical RMSfiles within a database is undefined and
can change at any time. This function is designed for scanning
all logical RMSfiles defined for one database; not looking for
one particular entry.

The structure returned by dlfindn is defined in the include file
.

SEE ALSO


dlfind(C-3), dlopen(C-3)

DIAGNOSTICS

A value of NULL is returned if there are fewer than n logical
RMSfiles defined for the given database.

NOTES


The returned value points to static data whose contents are
overwritten with every call.