edmiRemoteDeleteDatabase

To be completed
Delete an existing remote EDMdatabase^ in the specified server context, i.e. delete all data belonging to the actual database. After this function is performed, the actual remote database is nonexisting, hence the data in a deleted remote EDMdatabase^ cannot be recovered. Only closed remote databases can be deleted.
Related functions: edmiRemoteCreateDatabase, edmiRemoteOpenDatabase, edmiRemoteCloseDatabase, edmiDeleteDatabase
Header:
#include "sdai.h"
Prototype:
EdmiError edmiRemoteDeleteDatabase(SdaiServerContext serverContextId,
                                    SdaiString        location,
                                    SdaiString        databaseName,
                                    SdaiString        password,
                                    SdaiInvocationId  *edmiInvocationId);

Arguments:

serverContextId	Context identification, from edmiDefineServerContext
location	Specifies the path to the directory where the remote database is located. The <location> argument must be specified as an absolute path of the actual EDMserver^. The <location> argument can be specified with and without the directory delimiter character as the last character in the directory path. The directory delimiter character is '\' on the Windows platforms and '/' on the Unix platforms.
databaseName	Specifies the name of the remote EDMdatabase^ to delete. EDMdatabase^ names are case sensitive on the UNIX platforms and case insensitive on the Windows platforms.
password	Specifies the password for the actual database. The password for the database is defined by the edmiCreateDatabase function.
edmiInvocationId	Not yet used. When the edmiInvocationId is specified unequal NULL, the actual operation will be asynchronous and a handle (identifier) of the call will be returned in the edmiInvocationId argument. This handle can be used in later operations for requesting the status (waiting, running, finished ..) and the result of the avtual operation.

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
EdmiError rstat;
. . .