EssCreateStorageTypedApplicationEx

Creates a new application with options for data storage mode (block or aggregate) and application mode (Unicode or non-Unicode).

Syntax

ESS_FUNC_M EssCreateStorageTypedApplicationEx (hCtx, AppName, storageType, usAppType);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
AppName	ESS_STR_T	Name of application to create. See Application Name Limits.
StorageType	ESS_DATA_STORAGE_T	The data storage type of the new application. The valid values for StorageType are: ESS_DEFAULT_DATA_STORAGE ESS_MULTIDIM_DATA_STORAGE—Block storage (multidimensional), the default storage type ESS_ASO_DATA_STORAGE—Aggregate storage
usAppType	ESS_USHORT_T	The application type (Unicode or non-Unicode) of the new application. The valid values for usAppType are: ESS_APP_UNICODE - 0x0003—Unicode application. The function fails if the server is not in Unicode mode. ESS_APP_NONUNICODE - 0x0002—Non-Unicode application.

Notes

Creating a client application creates a directory to contain local application files.
A newly created database or application is not automatically set to active. Call EssSetActive() after calling EssCreateDatabase(), EssCreateApplication(), EssCreateApplicationEx(), EssCreateStorageTypedApplication(), or EssCreateStorageTypedApplicationEx() to keep subsequent functions, such as EssRestructure(), from operating on the wrong database or application (the application or database that is already active).

Return Value

Returns 0 if successful; otherwise, returns an error.

Access

For a server application, the caller must have Application Create/Delete/Edit privilege (ESS_PRIV_APPCREATE).

Example

ESS_FUNC_M
ESS_CreateASOApp (ESS_HCTX_T  hCtx)
{
   ESS_FUNC_M          sts = ESS_STS_NOERR;
   ESS_STR_T           AppName;
   AppName = "Sample";
   sts = EssCreateStorageTypedApplicationEx (hCtx, AppName,ESS_ASO_DATA_STORAGE, ESS_APP_UNICODE);
   return(sts);
}