DBMDeleteRecord

Description
특정 레코드를 삭제한다. deleteType에 따라서 physical deletion, virtual deletion, archive deletion을 구별한다.

Syntax
DBMErr DBMDeleteRecord(ScanId scanId, RecId recId, DeleteType deleteType);

Parameters
scanId스캔 ID
recId삭제할 레코드의 ID
deleteType DBM_VIRTUAL : 레코드의 DELETE_FLAG가 셋팅되면서, 레코드의 모든 필드 데이타가 지워짐. RID, 상태플래그, Category ID만 유지(virtual record가 됨)
DBM_PHYSICAL: physical deletion, 레코드를 완전 삭제
DBM_ARCHIVE : 레코드의 DELTE_FLAG, ARCHIVE_FLAG가 셋팅됨
Returns
value설명
DBM_OK레코드가 성공적으로 삭제된 경우
DBM_INVALID_SCAN_ID주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_INVALID_REC_ID주어진 레코드 id를 갖는 레코드가 존재하지 않는 경우
DBM_INVALID_FIELD_ID주어진 필드 id가 테이블 스키마에 존재하지 않는 경우
DBM_INVALID_FLAG deleteType이 DBM_VIRTUAL도DBM_PHYSICAL도 아닌 경우
DBM_MEM_ALLOC_ERR필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED 데이타베이스가 초기화되어 있지 않은 경우

Comments
DBM_ARCHIVE의 경우, 단지 레코드의 delete와 archive 플래그를 DBM_ON로 설정해줄 뿐, 실제 레코드는 삭제되지 않는다.
(일반 응용 프로그램에서는 DBM_PHYSICAL을 사용하지 않아야 함. DBM_PHYSICAL로 레코드를 삭제하면 sync가 제대로 수행되지 않을 수 있음)

Example
  /* Get scanId and recId. See the example of DBMDeleteFieldContent*/
  ret = DBMDeleteRecord(scanId, recId, DBM_VIRTUAL);
  if (ret == DBM_OK)
    //Success!
  else
    // error handling
    ...