다음을 통해 공유

JetPrereadIndexRanges 함수

  • 아티클

적용 대상: Windows | Windows Server

JetPrereadIndexRanges 함수는 인덱스를 미리 읽어 성능을 향상시킵니다.

JetPrereadIndexRanges 함수는 Windows 8 운영 체제에 도입되었습니다.

JET_ERR JetPrereadIndexRanges(
  __in          const JET_SESID sesid,
  __in          const JET_TABLEID tableid,
  __in_ecount(cIndexRanges)  const JET_INDEX_RANGE* const rgIndexRanges,
  __in          const unsigned long cIndexRanges,
  __out_opt     unsigned long* const pcRangesPreread,
  __in_ecount(ccolumnidPreread)  const JET_COLUMNID* const rgcolumnidPreread,
  __in          const unsigned long ccolumnidPreread,
  __in          const JET_GRBIT grbit
);

매개 변수

sesid

API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.

tableid

미리 읽기를 실행할 테이블입니다.

rgIndexRanges

미리 읽을 키 범위입니다.

cIndexRanges

rgIndexRanges의 요소 수에 따라 미리 읽을 키 범위의 수입니다.

pcRangesPreread

실제로 미리 읽은 키 범위의 수입니다.

rgcolumnidPreread

미리 읽을 긴 값 열의 열 ID 목록입니다. 기본적으로 페이지 내 레코드만 미리 읽습니다. 오프 페이지 길이 값 열을 미리 읽어야 하는 경우 해당 열 ID는 이 매개 변수를 통해 전달되어야 합니다.

ccolumnidPreread

rgcolumnidPreread의 요소 수에 따라 미리 읽을 긴 값 열의 열 ID 수입니다.

grbit

다음 표에 나열된 미리 읽기 방향 값을 0개 이상 지정하는 비트 그룹입니다.

값

의미

앞으로

앞으로 미리 읽습니다.

뒤로

뒤로 미리 읽습니다.

FirstPageOnly

긴 열의 첫 페이지만 미리 읽습니다.

NormalizedKey

열 값 대신 제공된 정규화된 키/책갈피입니다.

반환 값

이 함수는 다음 표에 나열된 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE(확장 가능한 스토리지 엔진) 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

설명

지정된 키 범위의 레코드가 버퍼 캐시에 없는 경우 비동기 읽기를 시작하여 레코드를 데이터베이스 버퍼 캐시로 가져와야 합니다.

요구 사항

요구 사항 값

클라이언트

Windows 8 필요합니다.

서버

Windows Server 2012 필요합니다.

머리글

Esent.h에 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

추가 정보

JET_ERR