EssUnloadDatabase

Stops a database within an application on the server.

Syntax

ESS_FUNC_M  EssUnloadDatabase (hCtx, AppName, DbName);
ParameterData TypeDescription

hCtx

ESS_HCTX_T

API context handle.

AppName

ESS_STR_T

Application name.

DbName

ESS_STR_T

Name of database to unload.

Return Value

None.

Access

This function requires the caller to have database load/unload privilege (ESS_PRIV_APPLOAD).

Example

ESS_FUNC_M
ESS_UnloadDb (ESS_HCTX_T  hCtx)
{
   ESS_FUNC_M        sts = ESS_STS_NOERR;
   ESS_STR_T        AppName;
   ESS_STR_T        DbName;
   AppName = "Sample";
   DbName  = "Basic";
   /*
    * IF the current active is the same as the 
    * unload db, ClearActive first
    */
       sts = EssClearActive(hCtx);
   /*
    * ELSE
    */   
       sts = EssUnloadDatabase(hCtx, AppName,
             DbName);
   return (sts);
}

See Also