EssOtlIsMemberNameUniqueWithinDim

Discovers if member names are all unique within a dimension.

Syntax

ESS_FUNC_M EssOtlIsMemberNameUniqueWithinDim (hOutline, hDim, *pbNameUnique);

Parameter	Data Type	Description
hOutline	ESS_HOUTLINE_T	Outline context handle (input).
hDim	ESS_HMEMBER_T	Input dimension, returned by EssOtlQueryGetFirstDimension() or EssOtlQueryGetNextDimension().
*pbNameUnique	ESS_BOOL_T	TRUE if the dimension queried contains no duplicate member names; FALSE otherwise.

Notes

This function is one of three functions that query for member name uniqueness or non uniqueness.
- EssOtlIsMemberNameNonUnique discovers if a member name is duplicate within an outline.
- EssOtlIsMemberNameUniqueWithinDim discovers if all member names are unique within a dimension.
- EssOtlIsMemberNameUniqueWithinDimAtGenLevel discovers if all member names are unique within a dimension at the generation or level specified.
Before you call this function, call EssOtlOpenOutlineQuery() to open the outline in query mode.

Return Value

Returns 0 if successful; otherwise, returns an error.

Example

ESS_FUNC_M ESS_ISUniq()
{
 ESS_STS_T    sts = 0;
 ESS_HOUTLINE_T   hOutline;
 ESS_OBJDEF_T   Object;
 ESS_APPNAME_T   szAppName;
 ESS_DBNAME_T   szDbName;
 ESS_OBJNAME_T   szFileName; 
 ESS_HMEMBER_T   hDim = ESS_NULL;
 ESS_BOOL_T    pbNameUnique = 0;
 

 memset(&Object, '\0', sizeof(Object));
 Object.hCtx =   hCtx;
 Object.ObjType =  ESS_OBJTYPE_OUTLINE;
 strcpy(szAppName, "Demo");
 strcpy(szDbName, "Test"); 
 strcpy(szFileName, "Test");
 Object.AppName =  szAppName;
 Object.DbName =   szDbName;
 Object.FileName =  szFileName;
 

 sts = EssOtlOpenOutlineQuery (hCtx, &Object, &hOutline);
 
 
 
 if (!sts)
 {
  sts = EssOtlQueryGetFirstDimension(hOutline, &hDim);
    
  if (sts)
   printf("EssOtlQueryGetFirstDimension failed sts %ld\n",sts);
 }
 
 
 
 if (!sts)
 {
   sts =  EssOtlIsMemberNameUniqueWithinDim (hOutline, hDim, &pbNameUnique);
   if (sts)
    printf("EssOtlIsMemberNameUniqueWithinDim failed sts %ld\n",sts);
   else
    printf("pbNameUnique is %d\n", pbNameUnique);
 }
 

 return sts;
}