EsbRenameApplication

Description

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

Syntax
EsbRenameApplication (hCtx, AppName, nAppName)
ByVal hCtx     As Long
ByVal AppName  As String
ByVal nAppName As String

Parameters

hCtxEssbase VB API context handle.
AppNameName of an existing application to rename.
nAppNameNew name of the 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 (ESB_PRIV_APPCREATE).

Example

Declare Function EsbRenameApplication Lib "ESBAPIW" (ByVal hCtx As Long, ByVal OldName As String, ByVal NewName As String) As Long

Sub ESB_RenameApplication ()
   Dim sts As Long
   Dim OldName As String 
   Dim NewName As String

   OldName = "Sample"
   NewName = "NewSamp"

   '*******************
   ' Rename Application
   '*******************
   sts = EsbRenameApplication (hCtx, OldName,
         NewName) 
End Sub

See Also

EsbRenameDatabase()
EsbRenameObject()