EssRenameApplication

Description

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

Syntax

ESS_FUNC_M  EssRenameApplication (hCtx, OldName, NewName);
ESS_HCTX_ThCtx
ESS_STR_TOldName
ESS_STR_TNewName

Parameters

hCtxEssbase API context handle.
OldNameName of existing application to rename.
NewNameNew name of application. Application names can be 8 characters long, and can contain all special characters allowed in DOS file names. No spaces, commas, backslashes, or periods are allowed.

Return Value

None.

Notes

Access

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

Example

ESS_FUNC_M
ESS_RenameApp (ESS_HCTX_T hCtx)
{
   ESS_FUNC_M  sts = ESS_STS_NOERR;
   ESS_STR_T  OldName;
   ESS_STR_T  NewName;   
  
   OldName = "Sample";
   NewName = "Sample2";
   sts = EssRenameApplication(hCtx, OldName,
         NewName);
   
   return (sts);
}

See Also

EssRenameDatabase()
EssRenameObject()