as_DBMSetRecordStatus

as_DBMSetRecordStatus

Description
레코드의 archive flag나 secret flag의 값을 DBM_ON으로 지정한다.

Syntax
DBMErr as_DBMSetRecordStatus(ScanId scanId, RecId recId, StatusFlag flag);

Parameters

scanId	스캔 ID
recId	레코드 ID
flag	DBM_OFF로 지정하고자 하는 상태 플래그의 종류로서 다음 두가지 값 중 하나를 가질 수 있다. ARCHIVE_FLAG, SECRET_FLAG

Returns

value	설명
DBM_OK	성공적으로 수행된 경우
DBM_INVALID_SCAN_ID	주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_INVALID_REC_ID	주어진 레코드 id를 갖는 레코드가 존재하지 않는 경우
DBM_INVALID_FLAG	flag가ARCHIVE_FALG나SECRET_FLAG가 아닌 경우
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우

Comments
ADD_FLAG, MODIFY_FLAG, DELETE_FLAG 플래그에 대해서는 as_DBMSetRecordStatus 함수를 적용할 수 없다.
즉, ARCHIVE_FLAG, SECRET_FLAG 에 대해서만 애플리케이션이 위 함수를 이용하여 명시적으로 DBM_ON으로 지정할 수 있다.

Examples
/* Get scanId and recId. See the example of as_DBMDeleteFieldContent */
StatusFlag flag = SECRET_FLAG;
ret = as_DBMSetRecordStatus(scanId, recId, flag);
if( ret < DBM_OK) // error handling