Creates an EDMdatabase from a thin EDMclient.
Note that this function will fail if the EDMserver, specified in the server context, is already connected to an open _EDMdatabase{_}.
When an EDMdatabase is created by this function, the factory setting includes the two EDMusers named superuser and sdai-user, and the EDMgroup named sdai-group. The superuser is a privileged user of the EDMdatabase. By default, the superuser password will be the same as that of the EDMdatabase. The password may be changed by a later call to the function edmiRemoteDefinePassword.
Note that the EDMdatabase password will be set at creation time and may not be changed.
Related functions: edmiRemoteOpenDatabase, edmiRemoteCloseDatabase, edmiRemoteDeleteDatabase
Header:
#include "sdai.h"
Prototype:
EdmiError edmiRemoteCreateDatabase(SdaiServerContext serverContextId,
SdaiString location,
SdaiString databaseName,
SdaiString password);
Arguments:
serverContextId |
Context identification, from edmiDefineServerContext |
location |
The full path to the directory on the remote file system where the database files will be located. The remote file system is the file system of the _EDMserver{_}. |
databaseName |
The name to assign to the _EDMdatabase{_}. _EDMdatabase_ names are case sensitive on Unix platforms and case insensitive on Windows platforms. |
password |
The password to apply to the EDMdatabase. Note that this password will be a fixed property of the database and may never be changed. |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0 : Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an _EDMinterface_ error code. Use edmiGetErrorText to get the error text corresponding to the error code.
Example:
. . .