as_DBMDropCategory

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

Syntax
DBMErr as_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
as_DBMMoveCategory과는 달리, 해당 Category에 속하는 모든 레코드들이 삭제(virtual deletion)된다는 사실에 주의해야 한다.

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

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