DBMInsertRecordWithField

DBMInsertRecordWithField

Description
특정 테이블에 주어진 필드 데이타를 가지는 레코드를 추가한다.

Syntax
DBMErr DBMInsertRecordWithField(ScanId scanId, S32 numFieldData, FieldData* filedData, RecId* recId);

Parameters

scanId	스캔 ID
numFieldData	필드 데이타 수
fieldData	각 필드의 데이타 값을 가지는 배열
recId	성공한 경우 unique record ID 값을 반환

Returns

value	설명
DBM_OK	성공적으로 수행된 경우
DBM_INVALID_SCAN_ID	주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_INVALID_FIELD_ID	테이블 스키마에 존재하지 않는 필드 id가 주어진 경우
DBM_INVALID_FIELD_TYPE	테이블 스키마와 일치하지 않는 필드 데이타 타입이 주어진 경우
DBM_INVALID_FIELD_LEN	0보다 작거나 같은 len을 가지는 필드 데이타가 주어진 경우
DBM_MEM_ALLOC_ERR	필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우

Comments
DBMInsertRecordWirhField함수는 레코드의 헤더 정보와 필드 데이타를 생성하며, DBMSetFieldContent함수를 이용하여 필드의 값을 변경/추가 할 수 있다.

레코드의 add 플래그가 DBM_ON로 설정된다
테이블의 modify count를 증가한다.

Example
  /* Get scanId. See the example of DBMDeleteFieldContent */

  FieldData fieldData[NUM_FIELDS];
  S32 numFields;
  RecId recId;

  numFields = 2;
  fieldData[0].id = 0;
  fieldData[0].type = DBM_INT2;
  fieldData[0].len = 2;
  fieldData[0].content.int2val = 10;
  fieldData[1].id = 2;
  fieldData[1].type = DBM_STRING;
  fieldData[1].len = 5;
  strcpy(filedData[1].content.str, "name");

  ret = DBMInsertRecordWithField(scanId, numFields, fieldData, &recId);
  if (ret < DBM_OK) // error handling