JetSetColumns 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetSetColumns 함수

JetSetColumns 함수는 JetSetColumn과 동작이 비슷하지만 애플리케이션이 단일 작업에서 여러 열 값을 설정할 수 있도록 합니다. JET_SETCOLUMN 구조의 배열은 설정할 열 값 집합을 설명하고 설정할 각 열 값에 대한 입력 버퍼를 설명하는 데 사용됩니다.

    JET_ERR JET_API JetSetColumns(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in_out_opt  JET_SETCOLUMN* psetcolumn,
      __in          unsigned long csetcolumn
    );

매개 변수

sesid

이 호출에 사용할 세션입니다.

tableid

이 호출에 사용할 커서입니다.

psetcolumn

하나 이상의 JET_SETCOLUMN 구조체 배열에 대한 포인터입니다. 각 구조에는 설정할 열 값과 설정할 열 데이터를 가져올 위치에 대한 설명이 포함됩니다.

csetcolumn

psetcolumn에서 제공하는 배열의 JET_SETCOLUMN 구조체 수입니다.

반환 값

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

반환 코드	설명
JET_errBadColumnId	지정된 열 ID가 열 ID의 법적 제한을 벗어집니다.
JET_errClientRequestToStopJetService	JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.
JET_errColumnIllegalNull	JET_errNullInvalid 동일합니다.
JET_errColumnNotFound	지정된 columnid 에 의해 설명된 열이 테이블에 없습니다.
JET_errColumnNotUpdatable	삽입 복사 삭제 원래 업데이트 작업 중에 긴 값을 업데이트하려고 잘못 시도했습니다.
JET_errColumnTooBig	입력 버퍼에 지정된 열 값 데이터가 고정 길이 열에 대해 자연스럽거나 고정 길이 텍스트 또는 이진 열에 대해 구성된 크기 제한을 초과합니다. 이 오류는 긴 열에 대해 1024바이트 이상의 데이터를 전달하고 JET_bitSetIntrinsicLV 플래그를 설정할 때도 반환됩니다.
JET_errInstanceUnavailable	세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.
JET_errInvalidBufferSize	지정된 열 값 데이터 크기가 고정 길이 데이터 형식에 대한 자연 항목과 일치하지 않습니다.
JET_errInvalidColumnType	삽입 또는 업데이트 작업 중에 자동 증가 열을 업데이트하거나 바꾸기 작업 중에 버전 열을 업데이트하려는 시도가 잘못되었습니다.
JET_errInvalidgrbit	제공된 옵션은 알 수 없거나 알려진 비트 설정의 잘못된 조합입니다.
JET_errInvalidParameter	지정된 psetinfo-cbStruct>는 JET_SETINFO 구조체에 유효한 크기가 아닙니다.
JET_errMultiValuedDuplicate	열 설정 작업에서 중복 값을 만들려고 했고 JET_bitSetUniqueMultiValues 또는 JET_bitSetUniqueNormalizedMultiValues 지정했습니다.
JET_errNotInitialized	세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.
JET_errNotInTransaction	호출 세션이 트랜잭션에 없을 때 긴 열 값을 업데이트하려고 잘못 시도했습니다.
JET_errNullInvalid	NULL이 아닌 열을 NULL로 설정하려고 잘못 시도했습니다.
JET_errRecordTooBig	열 값은 레코드가 페이지 크기 관련 크기 제한을 초과하게 했기 때문에 입력 버퍼의 값으로 설정할 수 없습니다. JET_coltypLongText 또는 JET_coltypLongBinary 형식의 열은 나머지 레코드 데이터와 별도로 저장할 수 있습니다. 그러나 다른 열은 레코드와 함께 저장되어야 하며 레코드 크기 제한을 초과할 수 있습니다. 긴 열에도 링크로 레코드 내의 5바이트 공간이 필요하며 이로 인해 JET_errRecordTooBig 반환될 수 있습니다.
JET_errRestoreInProgress	세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.
JET_errSessionSharingViolation	두 개 이상의 스레드에 대해 동시에 동일한 세션을 사용할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.
JET_errTermInProgress	세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.
JET_errUpdateNotPrepared	커서는 현재 새 레코드를 삽입하거나 기존 레코드를 업데이트하는 과정에 있지 않습니다.
JET_wrnColumnMaxTruncated	입력 버퍼의 열 값이 가변 길이 열에 대해 구성된 최대 길이를 초과하여 잘렸습니다.

성공하면 psetcolumns에 설명된 각 열에 대해 열 값의 원하는 부분이 입력 버퍼에서 복사된 데이터로 설정됩니다. 열 데이터 집합이 가변 길이 열에 대해 지정된 최대 길이를 초과하면 잘렸을 수 있습니다.

오류가 발생한 경우 커서 위치는 변경되지 않고 복사 버퍼에서 열 값 데이터가 업데이트되지 않습니다.

설명

개별 집합 열 작업이 오류를 반환하는 경우 전체 JetSetColumns 작업에서 오류를 반환합니다. 일반적으로 경고는 이 함수의 반환 코드가 아니라 psetcolumns-error>로 반환됩니다. 그러나 마지막 열 집합에 경고가 있는 경우 이 경고는 JetSetColumns 자체에서 반환됩니다.

요구 사항

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

참고 항목

JET_COLTYP
JET_ERR
JET_SESID
JET_TABLEID
JET_SETCOLUMN
JetRetrieveColumns
JetSetColumn

JetSetColumns 함수