EssRenameDatabase

Description

EssRenameDatabase() renames an existing database within an application, either on the client or the server. If the database is running on the server, it is first stopped.

Syntax

ESS_FUNC_M  EssRenameDatabase (hCtx, AppName, OldName, NewName); 
ESS_HCTX_ThCtx
ESS_STR_TAppName
ESS_STR_TOldName
ESS_STR_TNewName

Parameters

hCtxEssbase API context handle.
AppNameApplication name.
OldNameName of existing database to rename.
NewNameNew name of database.

Return Value

None.

Notes

Access

For a server database, the caller must have Database Create/Delete/Edit privilege (ESS_PRIV_DBCREATE).

Example

ESS_FUNC_M 
ESS_RenameDatabase (ESS_HCTX_T hCtx)
{
   ESS_FUNC_M  sts;
   ESS_STR_T  AppName;
   ESS_STR_T  OldName;
   ESS_STR_T  NewName;
   
   AppName = "Sample";
   OldName = "Basic";
   NewName = "Basic2";
   
   sts = EssRenameDatabase(hCtx, AppName, OldName,
         NewName);
   
   return(sts);
}

See Also

EssRenameApplication()
EssRenameObject()