JET_RETINFO 구조체

아티클
06/13/2023

적용 대상: Windows | Windows Server

JET_RETINFO 구조체

JET_RETINFO 구조체에는 JetRetrieveColumn에 대한 선택적 입력 및 출력 매개 변수가 포함되어 있습니다. 이 구조체에 대한 포인터가 전달되지 않는 경우 null 포인터를 전달할 수 있습니다. null 포인터 전달은 cbStruct가 sizeof(JET_RETINFO), ibLongValue가 0으로 설정되고 itagSequence가 1로 설정된 JET_RETINFO 전달하는 것과 같습니다.

    typedef struct {
      unsigned long cbStruct;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
    } JET_RETINFO;

멤버

cbStruct

JET_RETINFO 구조체의 크기(바이트)로 설정해야 하며 다음 필드가 있는지 확인하는 역할을 합니다.

ibLongValue

JET_coltypLongBinary 형식의 열에서 검색할 첫 번째 바이트에 대한 오프셋이거나 JET_coltypLongText. 이 오프셋에서 검색된 데이터의 양은 출력 버퍼 크기보다 낮고 이 오프셋 이후의 실제 값에 있는 데이터의 크기입니다.

itagSequence

다중값 열의 값 시퀀스 번호를 설명합니다. 값의 배열은 1 기반입니다. 첫 번째 값은 0이 아닌 시퀀스 1입니다. 레코드 열에 값이 하나만 있는 경우 1을 itagSequence로 전달해야 합니다.

여러 값을 포함할 수 있는 열을 사용하면 JetSetColumn 및 JetRetrieveColumn에서 1보다 크거나 JetSetColumn에서 0보다 큰 시퀀스 번호만 사용할 수 있습니다. 엔진의 현재 구현에서 JET_bitColumnTagged 사용하여 만든 모든 열에는 여러 값이 포함될 수 있습니다. JET_bitColumnMultiValued 사용하여 만든 열은 인덱싱되는 방식에서만 다중값 태그가 지정된 열과 다릅니다. 자세한 내용은 JET_INDEXCREATE 참조하세요.

columnidNextTagged

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

요구 사항

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

참고 항목

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn

JET_RETINFO 구조체