DBMGetInfoCategories

Description
특정 테이블에 속한 Category들의 정보를 구한다.

Syntax
DBMErr DBMGetInfoCategories(TableId tableId, Cat *catInfos, P_S32 actualNumCats);

Parameters
tableId테이블 ID
catInfos해당 테이블에 속하는 Category들의 정보(name, id)
actualNumCats 해당 테이블에 속하는 Category들의 수

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_TABLE_ID주어진 ID를 갖는 테이블이 존재하지 않는 경우
DBM_DB_NOT_INITED 데이타베이스가 초기화되어 있지 않은 경우

Comments
catInfos 변수는 DBM_NUM_CATS만큼(또는DBMGetNumCategories에서 얻은값)의 메모리를 할당하고 이 함수를 호출해야 한다.

반환값으로 catInfos를 읽을 때는 actualNumCats 만큼의 정보를 읽는다.

typedef struct {
  CatId id;
  S8 name[CAT_NAME_LEN+1];
  U16 recCount;
  U8 status;
  CatId syncCatId;
} Cat;

Example
  // get tableId;
  Cat *cats;
  S32 actualNumCats;
  S32 numCats;
  DBMErr ret;
  ret = DBMGetNumCategories(tableId, &numCats);
  if (ret == DBM_OK)
  {
     cats = (Cat )malloc(sizeof(Cat)*numCats);
     ret = DBMGetInfoCategories(tableId, cats, &actualNumCats);
     if (ret < DBM_OK) // error handling
  }