as_DBMInsertRecord

Description
특정 테이블에 레코드를 추가한다.

Syntax
DBMErr as_DBMInsertRecord(ScanId scanId, RecId* recId);

Parameters
scanId 스캔 ID
recId성공한 경우 unique record ID 값을 반환한다.

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

Comments
as_DBMInsertRecord함수는 레코드의 헤더 정보를 생성하며, 레코드의 실제 필드 데이타는 as_DBMSetFieldContent 함수를 이용하여 지정한다.
레코드의 add 플래그가 DBM_ON로 설정된다
테이블의 modify count를 증가한다.

Example
/* Get scanId. See the example of as_DBMDeleteFieldContent */
 RecId recId;

ret = as_DBMInsertRecord(scanId, &recId);
if (ret < DBM_OK) // error handling