as_DBMOpenSeqScanCategory

Description
특정 Category에 속하는 레코드들을 primary/secondary key 순서로 읽기 위한 스캔 관리자를 초기화한다

Syntax
DBMErr as_DBMOpenSeqScanCategory(TableId tableId, CatId catId, IndexFlag indexFlag, S32 offset, RecOrder recOrderFlag, ScanId* scanId);

Parameters
tableId 테이블의 ID
catId Category의 ID
indexFlag primary key 필드와 secondary key 필드 중 논리적 순서의 기준이 되는 필드를 선택하는 플래그
DBM_PRIM : primary key 필드
DBM_SEC : secondary key 필드
offset처음으로 읽을 레코드의 오프셋
recOrderFlag 레코드의 검색 순서
DBM_INCR : increasing order
DBM_DECR : decreasing order
scanId open된 스캔 ID 반환

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_TOO_MANY_SCANS이미 open된 스캔의 수가 NUM_SCANS인 경우
DBM_INVALID_TABLE_ID주어진 테이블 id를 갖는 테이블이 존재하지 않는 경우
DBM_INVALID_CAT_ID주어진 Category id를 갖는 Category가 존재하지 않는 경우
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우

Comments
스캔을 open한 이후, 최초로 호출되는 as_DBMGetNextRecordId 또는 as_DBMGetPrevRecordId는 처음 레코드 ID를 반환한다.

See Also
as_DBMGetNextRecordId, as_DBMGetPrevRecordId, as_DBMOpenSeqScanTable, as_DBMOpenSeqScanCategoryWithCursor

Example
TableId tableId; ScanId scanId;
RecId recId; DBMErr ret=DBM_OK;
int numFields, numExistFields; FieldDataInfo fieldDataInfo;
FieldData keyData, fieldData;
IndexFlag indexFlag = DBM_PRIM;
CatId catId;
int offset = 10;
RecOrder recOrder=DBM_INCR;

// Get tableId, catId
 ret = as_DBMOpenSeqScanCategory( tableId, catId, indexFlag, offset, recOrder, &scanId);
if( ret < DBM_OK ) // error handling
numFields = NUM_FIELDS;
...
/* allocate space for fieldDataInfo */
 fieldDataInfo =(FieldDataInfo*)Lmalloc( sizeof(FieldDataInfo) * numFields );
while( (ret = as_DBMGetNextRecordId( scanId, &recId, &numExistFields,
fieldDataInfo) >= DBM_OK ) {
   ...
 }