DBMDropCategory

Description
특정 Category 관련 정보와 그 Category에 속하는 모든 레코드들을 테이블로부터 삭제한다.

Syntax
DBMErr DBMDropCategory(TableId tableId, CatId catId);

Parameters
tableId 테이블의 ID
catId 삭제할 Category의 ID

Returns
value설명
DBM_OK 성공적으로 수행된 경우
DBM_INVALID_TABLE _ID주어진 테이블 id를 갖는 테이블이 존재하지 않는 경우
DBM_INVALID_CAT_ID주어진 id의 Category가 존재하지 않는 경우
DBM_MEM_ALLOC_ERR 필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우

Comments
DBMMoveCategory과는 달리, 해당 Category에 속하는 모든 레코드들이 삭제(virtual deletion)된다는 사실에 주의해야 한다.

Example
  // get tableId ;
  // get catId = 1;

  ret = DBMDropCategory(tableId, catId);
  if (ret < DBM_OK) // error handling