JET_RETRIEVECOLUMN 구조체

아티클
06/13/2023

적용 대상: Windows | Windows Server

JET_RETRIEVECOLUMN 구조체

JET_RETRIEVECOLUMN 구조에는 JetRetrieveColumns에 대한 입력 및 출력 매개 변수가 포함됩니다. 구조체의 필드는 검색할 열 값, 검색 방법 및 결과를 저장할 위치를 설명합니다.

    typedef struct {
      JET_COLUMNID columnid;
      void* pvData;
      unsigned long cbData;
      unsigned long cbActual;
      JET_GRBIT grbit;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
      JET_ERR err;
    } JET_RETRIEVECOLUMN;

멤버

columnid

검색할 열의 열 식별자입니다.

pvData

열 값에서 검색되는 데이터 저장을 시작하는 포인터입니다.

cbData

pvData에서 시작하는 할당 크기(바이트)입니다. 열 검색 작업은 cbData보다 더 많은 데이터를 pvData에 저장하지 않습니다.

cbActual

열 검색 작업에 의해 검색되는 데이터의 크기(바이트)입니다.

grbit

다음 값 중 0개 이상을 포함하는 열 검색 옵션이 포함된 비트 그룹입니다.

값	의미
JET_bitRetrieveCopy	원래 값 대신 수정된 값을 검색합니다. 값이 수정되지 않은 경우 원래 값이 검색됩니다. 이러한 방식으로 레코드를 삽입하거나 업데이트할 때 아직 삽입되거나 업데이트되지 않은 값을 검색할 수 있습니다.
JET_bitRetrieveFromIndex	가능한 경우 레코드에 액세스하지 않고 인덱스에서 열 값을 검색합니다. 이러한 방식으로 인덱스 항목 자체에서 필요한 데이터를 사용할 수 있는 경우 불필요한 레코드 로드를 방지할 수 있습니다. 되돌릴 수 없는 변환 또는 데이터 잘림으로 인해 인덱스에서 원래 열 값을 검색할 수 없는 경우 레코드에 액세스하고 데이터를 정상적으로 검색합니다. 이는 성능 옵션이며 열 값을 인덱스에서 검색할 수 있는 경우에만 지정해야 합니다. 클러스터형 또는 기본 인덱스에 대한 인덱스 항목이 레코드 자체이므로 현재 인덱스가 클러스터형 인덱스인 경우 이 옵션을 지정하면 안 됩니다. JET_bitRetrieveFromPrimaryBookmark 설정되면 이 비트를 설정할 수 없습니다.
JET_bitRetrieveFromPrimaryBookmark	인덱스 책갈피에서 열 값을 검색하고 기본 인덱스와 현재 인덱스에 열이 모두 표시되면 인덱스 값과 다를 수 있습니다. 현재 인덱스가 클러스터형 인덱스 또는 기본 인덱스인 경우 이 옵션을 지정해서는 안 됩니다. JET_bitRetrieveFromIndex 설정되면 이 비트를 설정할 수 없습니다.
JET_bitRetrieveTag	pretinfo-itagSequence>에서 다중값 열 값의 시퀀스 번호를 검색합니다. itagSequence 필드는 레코드에서 다중값 열 값을 검색하기 위한 입력으로 사용되는 경우가 많습니다. 그러나 인덱스에서 값을 검색할 때 인덱스 항목을 특정 시퀀스 번호와 연결하고 이 시퀀스 번호도 검색할 수 있습니다. 시퀀스 번호 검색은 비용이 많이 드는 작업일 수 있으며 필요한 경우에만 수행해야 합니다.
bitRetrieveNull JET_	다중값 열 NULL 값을 검색합니다. 이 옵션을 지정하지 않으면 다중값 열 NULL 값이 자동으로 건너뜁니다.
JET_bitRetrieveIgnoreDefault	요청된 시퀀스 번호가 1이고 레코드에 열에 대해 설정된 값이 없는 경우 NULL 값이 반환됩니다. 이 옵션은 다중값 열에만 영향을 줍니다.
JET_bitRetrieveLongId	이 플래그는 내부 전용이며 애플리케이션에서 사용할 수 없습니다.
JET_bitRetrieveLongValueRefCount	이 플래그는 내부 전용이며 애플리케이션에서 사용할 수 없습니다.

ibLongValue

JET_coltypLongBinary 또는 JET_coltypLongText 형식의 열에서 검색할 첫 번째 바이트에 대한 오프셋입니다.

itagSequence

다중값 열에 포함된 값의 시퀀스 번호입니다. JET_RETRIEVECOLUMN 여기서 itagSequence는 0일 수 있습니다. itagSequence가 0이면 열 데이터 대신 다중값 열의 인스턴스 수가 반환됩니다. JetRetrieveColumn 호출에는 itagSequence 값 0을 사용할 수 없습니다.

columnidNextTagged

태그가 지정된 모든 열이 JetRetrieveColumn에 columnid로 0을 전달하여 검색될 때 태그가 지정된, 다중값 또는 스파스 열의 columnid입니다.

err

열 검색에서 반환된 오류 코드 및 경고입니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에서 선언되었습니다.

참고 항목

JET_COLTYP
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_RETRIEVECOLUMN
JetRetrieveColumn
JetRetrieveColumns

Share via

JET_RETRIEVECOLUMN 구조체