sdaiCreateEmptyADB
Creates an empty ADB container to be used for subsequent data get and put operations.
An ADB container can be used to get and put all EDMintercface data types except the sdaiADB data type, i.e., an ADB container cannot contain another ADB as the data value. Typed data value cannot be transferred in an ADB container.
All created ADB containers will be deleted when the actual _EDMserver_ session is closed, i.e. the ADB containers are not persistent in an EDMdatabase.
See related functions: sdaiCreateADB , sdaiDeleteADB , sdaiGetADBType , sdaiGetADBValue , sdaiPutADBValue
Header:
#include "sdai.h"
Prototype:
SdaiADB sdaiCreateEmptyADB(void);
Arguments:
None.
Returns:
A numeric adbID that uniquely identifies the new created ADB container for subsequent EDMinterface operations.
adbID != 0 : operation successfully performed.
adbID = 0 : operation failed, use sdaiErrorQuery function to get error reason.
Example:
SdaiADB adbId;
...
adbId = sdaiCreateEmptyADB();
if (! adbId) {
/* Error in operation */
printf("\nError: %s in sdaiCreateEmptyADB \n",
edmiGetErrorText(sdaiErrorQuery()));
goto error;
}
. . .