EssCreateApplicationEx

Creates a new application, either on the client or the server. If the application is created on the server, it is also started. This function can create Unicode mode applications.

Syntax

ESS_FUNC_M EssCreateApplicationEx(hCtx, AppName, 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.
usAppType		The application type (Unicode or non-Unicode) of the new application. The valid values are: ESS_APP_UNICODE - 0x0003—Create a Unicode application. The function fails if the server is not in Unicode mode. ESS_APP_NONUNICODE - 0x0002—Create a non-Unicode application.

Parameter

Data Type

Description

hCtx

ESS_HCTX_T

API context handle.

AppName

ESS_STR_T

Name of application to create. See Application Name Limits.

usAppType

The application type (Unicode or non-Unicode) of the new application.

The valid values are:

ESS_APP_UNICODE - 0x0003—Create a Unicode application. The function fails if the server is not in Unicode mode.
ESS_APP_NONUNICODE - 0x0002—Create a 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 EssCreateDatabaseEx() or EssCreateApplicationEx() 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).