EssSendString

Description

EssSendString() sends a string of data to the active database. The string must be less than 64 Kbytes long. This function should be called after EssBeginReport(), EssBeginUpdate(), or EssBeginCalc().

Syntax

ESS_FUNC_M  EssSendString (hCtx, String);
ESS_HCTX_ThCtx
ESS_STR_TString

Parameters

hCtxEssbase API context handle.
StringData string (must be less than 64 Kbytes in length.

Return Value

None.

Notes

Access

This function requires no special privileges.

Example

ESS_FUNC_M
ESS_Report (ESS_HCTX_T   hCtx,
            ESS_HINST_T  hInst
           )
{
   ESS_FUNC_M     sts     = ESS_STS_NOERR;
   ESS_STR_T     rString = NULL;
   sts = EssBeginReport (hCtx,ESS_TRUE,ESS_FALSE);
   if (!sts)
      sts = EssSendString (hCtx, "<Desc Year !");

   if (!sts)
      sts = EssEndReport (hCtx);
   /**************
    * Get report *
    **************/
   
   if (!sts)
      sts = EssGetString (hCtx, &rString);
   while ((!sts) && (rString != NULL))
   {
          printf ("%s", rString);
          EssFree (hInst, rString);
          sts = EssGetString (hCtx, &rString);
   }
   printf ("\r\n"); 
   
   return(sts);
}

See Also

EssBeginCalc()
EssBeginReport()
EssBeginUpdate()
EssGetString()