EssUnloadDatabase

Description

EssUnloadDatabase() stops a database within an application on the server.

Syntax

ESS_FUNC_M  EssUnloadDatabase (hCtx, AppName, DbName);
ESS_HCTX_ThCtx
ESS_STR_TAppName
ESS_STR_TDbName

Parameters

hCtxEssbase API context handle.
AppNameApplication name.
DbNameName of database to unload.

Return Value

None.

Access

This function requires the caller to have databaseLoad/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

EssLoadDatabase()
EssUnloadDatabase()