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);
ParameterData TypeDescription

hCtx

ESS_HCTX_T

API context handle.

OldName

ESS_STR_T

Name of existing application to rename.

NewName

ESS_STR_T

New name of application. See Application Name Limits.

Notes

Renaming a client application renames the local application directory.

Return Value

None.

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