JET_SETCOLUMN 구조체

아티클
06/13/2023

적용 대상: Windows | Windows Server

JET_SETCOLUMN 구조체

JET_SETCOLUMN 구조에는 JetSetColumns에 대한 입력 및 출력 매개 변수가 포함됩니다. 구조체의 필드는 설정할 열 값, 설정 방법 및 열 집합 데이터를 가져올 위치를 설명합니다.

    typedef struct {
      JET_COLUMNID columnid;
      const void* pvData;
      unsigned long cbData;
      JET_GRBIT grbit;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_ERR err;
    } JET_SETCOLUMN;

멤버

columnid

설정할 열의 열 식별자입니다.

pvData

열로 설정할 데이터에 대한 포인터입니다.

cbData

pvData에서 바이트 단위로 시작하는 할당 크기(바이트)입니다.

grbit

다음 중 0개 이상을 포함하는 이 호출에 사용할 옵션이 포함된 비트 그룹입니다.

값	의미
JET_bitSetAppendLV	JET_coltypLongText 또는 JET_coltypLongBinary 형식의 열에 데이터를 추가합니다. 기존 long 값의 크기를 확인하고 psetinfo에서 ibLongValue를 지정하여 동일한 동작을 수행할 수 있습니다. 그러나 기존 열 값의 크기를 알 필요가 없으므로 이 grbit를 사용하는 것이 더 간단합니다.
JET_bitSetOverwriteLV	기존 long 값을 새 데이터로 바꿉니다. 이 옵션을 사용하면 새 데이터를 설정하기 전에 기존 long 값이 0으로 설정된 것처럼 표시됩니다.
JET_bitSetSizeLV	입력 버퍼를 지정된 columnid에서 설명하는 long 값의 길이로 설정할 바이트 수로 해석하고 제공된 경우 psetinfo-itagSequence>의 시퀀스 번호로 설정합니다. 지정된 크기가 기존 열 값보다 크면 열이 0으로 확장됩니다. 크기가 기존 열 값보다 작으면 값이 잘립니다.
JET_bitSetZeroLength	값을 길이가 0으로 설정합니다. 일반적으로 열 값은 cbMax를 0으로 전달하여 NULL로 설정됩니다. 그러나 JET_coltypText 같은 일부 형식의 경우 열 값은 NULL 대신 0 길이일 수 있으며 이 옵션은 NULL과 0 길이를 구분하는 데 사용됩니다.
JET_bitSetSeparateLV	레코드 데이터의 나머지 부분과 별도로 JET_coltypLongText 또는 JET_coltypLongBinary 형식의 긴 값 열을 강제로 저장합니다. 이는 일반적으로 long 값의 크기가 나머지 레코드 데이터와 함께 저장되지 않도록 하는 경우에 발생합니다. 그러나 이 옵션은 long 값을 별도로 저장하도록 강제하는 데 사용할 수 있습니다. 4바이트 이하의 긴 값은 강제로 분리할 수 없습니다. 이러한 경우 옵션은 무시됩니다.
JET_bitSetUniqueMultiValues	다중값 열에 고유 값을 적용합니다. 이 옵션은 변환 없이 원본 열 데이터를 다른 기존 열 값과 비교하고 중복이 발견되면 오류가 반환됩니다. 이 옵션이 제공되면 JET_bitSetAppendLv, JET_bitSetOverwriteLV 및 JET_bitSetSizeLV 지정할 수도 없습니다.
JET_bitSetUniqueNormalizedMultiValues	다중값 열에 고유 값을 적용합니다. 이 옵션은 열 데이터의 정규화된 주요 변환을 유사하게 변환된 다른 기존 열 값과 비교하며 중복이 발견되면 오류가 반환됩니다. 이 옵션이 제공되면 JET_bitSetAppendLv, JET_bitSetOverwriteLV 및 JET_bitSetSizeLV 지정할 수도 없습니다.
JET_bitSetRevertToDefaultValue	이후 열 검색 작업에서 열이 기본 열 값을 반환하도록 합니다. 모든 기존 열 값이 제거됩니다. 이 옵션은 태그가 지정된 열, 스파스 또는 다중 값 열에만 적용됩니다.
JET_bitSetIntrinsicLV	가능한 경우 JET_coltypLongText 또는 JET_coltypeLongBinary 형식의 긴 값 열을 나머지 레코드 데이터와 함께 저장합니다. 일반적으로 긴 열은 길이가 1024바이트를 초과하거나 레코드 길이가 페이지 크기 관련 크기 제한을 초과할 때 별도로 저장됩니다. 그러나 이 옵션을 설정하면 나머지 레코드 데이터와 별도로 이 열 값을 저장하지 않고 오류 JET_errColumnTooBig 열 설정 작업이 실패합니다.

ibLongValue

JET_coltypLongBinary 형식의 열에서 검색할 첫 번째 바이트에 대한 오프셋이거나 JET_coltypLongText.

itagSequence

다중값 열의 값 시퀀스 번호를 설명합니다. itagSequence가 0이면 열 값 집합이 다중 값 열의 새 instance 추가되어야 함을 나타냅니다.

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
JetSetColumns

다음을 통해 공유

JET_SETCOLUMN 구조체