as_DBMCreateCategory

Description
테이블에 새로운 Category을 추가한다.

Syntax
DBMErr as_DBMCreateCategory(TableId tableId, CatId catId, P_S8 catName);

Parameters
tableId테이블 ID
catId Category ID
catName 추가되는 Category 이름
이름의 최대 길이는 CAT_NAME_LEN이다.
이름의 끝은 '\0'으로 식별한다.

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_TABLE_ID주어진 테이블 id를 갖는 테이블이 존재하지 않는 경우
DBM_TOO_MANY_CATS테이블에 정의된 Category 개수가 이미 NUM_CATS인 경우
DBM_INVALID_CAT_NAME(catName의 길이) < = 0이거나 (catName의 길이)>CAT_NAME_LEN인 경우
DBM_INVALID_CAT_ID동일한 id의 Category가 이미 존재하는 경우
DBM_CAT_NAME_EXIST동일한 이름의 Category가 이미 존재하는 경우
DBM_MEM_ALLOC_ERR필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED 데이타베이스가 초기화되어 있지 않은 경우

Comments
Category ID와 이름은 테이블 내에서 유일해야 하며, 응용 프로그램에서 설정하여 매개변수로 넘겨준다.

Example
// get tableId
CatId catId = 1;
char catName[CAT_NAME_LEN+1];

strcpy(catName, "Category1");
ret = as_DBMCreateCategory(tableId, catId, catName);
if (ret < DBM_OK) // error handling