EssOtlVerifyOutline() verifies that an outline is correct. The function returns both global outline errors and errors for each incorrect member.
ESS_FUNC_M EssOtlVerifyOutline (hOutline, pulErrors, pulCount, pMbrErrors);
| ESS_HOUTLINE_T | hOutline |
| ESS_PULONG_T | pulErrors |
| ESS_PULONG_T | pulCount |
| ESS_PPOUTERROR_T | pMbrErrors |
| hOutline | Outline context handle. |
| pulErrors | Pointer to bitmask destination for global outline errors.
Currently, this field has only one value:
ESS_OUTERROR_CURTOOMANYDIMS |
| pulCount | Count of members with errors. This defines the number of elements of the pMbrErrors array. |
| pMbrErrors | Pointer to an array with *pulCount members. Each element of the array contains the errors for a single member. |
Returns 0 if successful; otherwise one of the following:
ESS_OUTERROR_SHAREUDA
ESS_OUTERROR_DUPGENLEVNAME
#include <essapi.h>
#include <essotl.h>
ESS_STS_T sts = 0;
ESS_OBJDEF_T Object;
ESS_HOUTLINE_T hOutline;
ESS_ULONG_T ulErrors;
ESS_ULONG_T ulCount;
ESS_POUTERROR_T pMbrErrors = ESS_NULL;
ESS_APPNAME_T szAppName;
ESS_DBNAME_T szDbName;
ESS_OBJNAME_T szFileName;
memset(&Object, '\0', sizeof(Object));
Object.hCtx = hCtx;
Object.ObjType = ESS_OBJTYPE_OUTLINE;
strcpy(szAppName, "Sample");
strcpy(szDbName, "Basic");
strcpy(szFileName, "Basic");
Object.AppName = szAppName;
Object.DbName = szDbName;
Object.FileName = szFileName;
sts = EssOtlOpenOutline(hCtx, &Object, ESS_TRUE,
ESS_TRUE, &hOutline);
if (!sts)
{
sts = EssOtlVerifyOutline(hOutline, &ulErrors,
&ulCount, &pMbrErrors);
}
if (pMbrErrors)
{
EssFree(hInst, pMbrErrors);
}
EssOtlNewOutline()
EssOtlOpenOutline()
EssOtlWriteOutline()