EssListGroups() lists all groups who have access to a particular Essbase server, application or database.
ESS_FUNC_M EssListGroups (hCtx, AppName, DbName, pCount, ppGroupList);
ESS_HCTX_T | hCtx |
ESS_STR_T | AppName |
ESS_STR_T | DbName |
ESS_PUSHORT_T | pCount |
ESS_PPGROUPINFO_T | ppGroupList |
hCtx | Essbase API context handle. |
AppName | Application name. If NULL, lists all groups. |
DbName | databasename. If NULL, lists groups for all databases within application. |
pCount | Address of variable to receive count of groups. |
ppGroupList | Address of pointer to receive an allocated array of group info structures. |
If successful, returns a count of the number of groups in pCount, and list of groups with access to the specified application and database in ppGroupList.
This function requires no special privileges.
ESS_FUNC_M ESS_ListGroups (ESS_HCTX_T hCtx, ESS_HINST_T hInst ) { ESS_FUNC_M sts = ESS_STS_NOERR; ESS_USHORT_T Count; ESS_PGROUPINFO_T Groups = NULL; ESS_USHORT_T ind; sts = EssListGroups (hCtx, NULL, NULL, &Count, &Groups); if (!sts) { if (Count && Groups) { printf ("\r\n-----Group List-----\r\n\r\n"); for (ind = 0; ind < Count; ind++) printf ("Name->%s\r\n", Groups [ind].Name); EssFree (hInst, Groups); } else printf ("\r\nGroup List is Empty\r\n\r\n"); } return (sts); }