edmiRemoteGetBackupStatus

This function gives information about the current running backup process. The information is:

State of backup database thread
Directory and startup time of next backup (if backup is active)
Backup interval (if backup is active)
Directory, startup time and finished time of last backup finished.

Related functions: edmiRemoteBackupDatabase, edmiRemoteRestoreBackup, edmiRemoteStopBackup, edmiRemoteDeleteBackup, edmiRemoteReadBackupResults

Header:
#include "sdai.h"
Prototype:
EdmiError edmiRemoteGetBackupStatus(SdaiServerContext serverContextId,
SdaiString *resultString,
SdaiInvocationId *edmiInvocationId);

Arguments:

serverContextId	A context identification, from edmiDefineServerContext
resultString	The result string with information about the backup thread and latest backup.
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 actual 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;
SdaiServerContext contextId;
SdaiString resultString;

/* Create Server Context */
rstat = edmiDefineServerContext("MyContext",
"Johnny", "Supervisor", "cf37ftr",
"TCP", "9090", "MyServerHost",
NULL, NULL, NULL, NULL, NULL, &contextId);

/* Get current backup status */
if (rstat = edmiRemoteGetBackupStatus(contextId, resultString, NULL) {
printf("\nError %d in edmiRemoteGetBackupStatus: %s", rstat,
edmiGetErrorText(rstat));
goto error;
}
...