EssAlloc

Description

EssAlloc() allocates a block of memory, using the defined memory allocation scheme.

Syntax

ESS_FUNC_M EssAlloc (hInstance, Size, ppBlock); 
ESS_HINST_ThInstance
ESS_SIZE_TSize
ESS_PPVOID_TppBlock

Parameters

hInstanceEssbase API instance handle.
SizeSize of memory block to allocate.
PpBlockAddress of pointer to receive allocated memory block.

Return Value

Returns a pointer to the allocated memory block in ppBlock.

Notes

Access

This function requires no special privileges.

Example

ESS_FUNC_M ESS_GetAppActive (ESS_HCTX_T hCtx,
          ESS_HINST_T hInst)
{
   ESS_FUNC_M     sts = ESS_STS_NOERR;
   ESS_STR_T     pDbName;
   ESS_STR_T     pAppName;
   ESS_ACCESS_T  Access;
   
   if ((sts = EssAlloc (hInst, 80, (ESS_PPVOID_T)&pAppName)) == 0)
   {
      if ((sts = EssAlloc (hInst, 80, (ESS_PPVOID_T)&pDbName)) == 0) 
      {
         if ((sts = EssGetActive (hCtx, &pAppName, &pDbName, &Access)) == 0)
         {
            if (pAppName)
            {
               if (*pAppName)
                  printf ("Current active application is [%s]\r\n",pAppName);
               else
                  printf ("No active Application is set\r\n");
               printf ("\r\n");
            }            
         }
         EssFree (hInst, pDbName);
      }
      EssFree (hInst, pAppName);
   }
   return (sts);   
}

See Also

EssFree()
EssInit()
EssRealloc()