EssCreateApplication

Creates a new application, either on the client or the server. If the application is created on the server, it is also started.

Syntax

ESS_FUNC_M EssCreateApplication (hCtx, AppName);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
AppName	ESS_STR_T	Name of application to create. See Application Name Limits.

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() or EssCreateApplication() to keep subsequent functions, such as EssRestructure(), from operating on the wrong database or application (the application or database that is already active).
To create a Unicode mode application, use EssCreateApplicationEx.

Return Value

None.

Access

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

Example

ESS_FUNC_M
ESS_CreateApp (ESS_HCTX_T  hCtx)
{
   ESS_FUNC_M        sts = ESS_STS_NOERR;
   ESS_STR_T        AppName;
   AppName = "Sample";
   sts = EssCreateApplication (hCtx, AppName);
   return(sts);
}