EssCreateObject

Description

EssCreateObject() creates a new object on the server or client object system.

Syntax

ESS_FUNC_M EssCreateObject (hCtx, ObjType, AppName, DbName, ObjName);
ESS_HCTX_ThCtx
ESS_OBJTYPE_TObjType
ESS_STR_TAppName
ESS_STR_TDbName
ESS_STR_TObjName

Parameters

hCtxEssbase API context handle. Can be local context handle returned by EssCreateLocalContext().
ObjTypeObject type (must be single type). Refer to Bitmask Data Types for a list of possible values.
AppNameApplication name
DbNameDatabase name. If NULL, uses the Application subdirectory.
ObjNameName of object to create

Return Value

None.

Notes

Access

This function requires the caller to have Application or Database Design privilege (ESS_PRIV_APPDESIGN or ESS_PRIV_DBDESIGN) for the specified application or database to contain the object.

Example

ESS_FUNC_M 
ESS_CreateObject (ESS_HCTX_T hCtx)   
{
   ESS_FUNC_M        sts = ESS_STS_NOERR;
   ESS_STR_T       AppName;
   ESS_STR_T       DbName;
   ESS_STR_T       ObjName;       
   ESS_OBJTYPE_T   ObjType;     
   
   AppName = "Sample";
   DbName  = "Basic";
   ObjName = "Test";
   ObjType = ESS_OBJTYPE_OUTLINE; 
   
   sts = EssCreateObject(hCtx, ObjType, AppName, 
         DbName, ObjName); 
   
   if(!sts)
      printf("The Object is created.\r\n");
   return (sts);
}

See Also

EssCopyObject()
EssDeleteObject()
EssListObjects()
EssLockObject()
EssPutObject()
EssRenameObject()