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);
| Parameter | Data Type | Description |
|---|---|---|
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