as_DBMGetInfoCategories

as_DBMGetInfoCategories

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

Syntax
DBMErr as_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만큼(또는as_DBMGetNumCategories에서 얻은값)의 메모리를 할당하고 이 함수를 호출해야 한다.

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

typedef struct {

	CatId	id;
	Char	name[CAT_NAME_LEN+1];
	U16	recCount;
	U8	status;
	CatId	syncCatId;

} Cat;

Example
// get tableId;
Cat *cats;
S32 actualNumCats;
S32 numCats;
DBMErr ret;

ret = as_DBMGetNumCats(tableId, &numCats);
if (ret == DBM_OK)
{
   cats = (Cat )malloc(sizeof(Cat)*numCats);
   ret = as_DBMGetInfoCategories(tableId, cats, &actualNumCats);
   if (ret < DBM_OK) // error handling
}