DtSearchReinit(library call) DtSearchReinit(library call)
NAME [Toc] [Back]
DtSearchReinit - Reinitialize the DtSearch online API
SYNOPSIS [Toc] [Back]
#include <Dt/Search.h>
int DtSearchReinit(
char ***dbnames,
int *dbcount);
DESCRIPTION [Toc] [Back]
DtSearchReinit closes and reopens databases and other files as
necessary, and reinitializes the search engine API.
It is typically used after either databases or the ocf file have been
externally changed to force the search engine to reinitialize itself,
and to acquire the new database names if any.
It can also be used after any function returns DtSrREINIT to acquire
the new database names.
ARGUMENTS [Toc] [Back]
dbnames Specifies the address where a pointer to an array of static
database name string pointers will be placed. The dbnames
pointer from a previous DtSearchInit or DtSearchReinit may
no longer be valid. Each string identifies a single
successfully opened database.
A database name string from this array is required for most
other API function calls. The dbn member in DtSrResult is an
index into this array.
dbcount Specifies a pointer where the size of the dbnames array will
be stored.
RETURN VALUE [Toc] [Back]
DtSearchReinit returns DtSrOK and the current dbnames array if the
reinitialization was successful or if reinitialization was not
necessary.
It returns DtSrERROR and messages on the MessageList on any other
condition.
SEE ALSO [Toc] [Back]
DtSrAPI(3), DtSearchInit(3), DtSearchGetMessages(3), dtsrocffile(4),
DtSearch(5)
- 1 - Formatted: January 24, 2005 [ Back ] |
