JetGetColumnInfo 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetGetColumnInfo 함수

JetGetColumnInfo 함수는 열에 대한 정보를 검색합니다.

    JET_ERR JET_API JetGetColumnInfo(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szTableName,
      __in          const tchar* szColumnName,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

매개 변수

sesid

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

dbid

szTableName과 함께 정보가 검색되는 열이 포함된 테이블을 식별합니다.

szTableName

dbid와 함께 정보가 검색되는 열이 포함된 테이블을 식별합니다.

szColumnName

정보를 가져올 열의 이름입니다.

pvResult

정보를 수신할 버퍼에 대한 포인터입니다. 버퍼의 형식은 InfoLevel에 따라 달라집니다. 버퍼를 적절하게 정렬하도록 호출자를 구성해야 합니다.

cbMax

pvResult로 전달되는 버퍼의 크기(바이트)입니다.

InfoLevel

szColumnName으로 지정된 열에 대해 검색할 정보의 형식입니다. pvResult에 저장된 데이터의 형식은 이 매개 변수에 따라 달라집니다. 임시 테이블의 스키마는 JET_COLUMNLIST 참조하세요.

이러한 InfoLevels는 다음으로 구분됩니다.

JET_ColInfoListSortColumnid 임시 테이블을 columnid로 정렬합니다.
JET_ColInfoListCompact 출력을 압축합니다. 압축 출력에 대한 자세한 내용은 JET_COLUMNLIST.

이 매개 변수와 함께 사용할 수 있는 옵션은 다음과 같습니다.

값	의미
JET_ColInfo	JET_ColInfo 및 JET_ColInfoByColid 모두 동일한 정보를 검색합니다. pvResult 는 JET_COLUMNDEF 해석되고 JET_COLUMNDEF 구조체의 필드가 적절하게 채워집니다.
JET_ColInfoBase	pvResult 는 JET_COLUMNBASE 구조체로 해석됩니다. 이는 JET_COLUMNDEF 구조와 비슷합니다. 이 함수가 성공하면 구조체가 적절한 값으로 채워집니다. 이 함수가 실패하면 구조체에 정의되지 않은 데이터가 포함됩니다.
JET_ColInfoByColid	JET_ColInfo 마찬가지로 pvResult 는 JET_COLUMNDEF 해석됩니다. 단, 이 InfoLevel 은 요청된 열(szColumName)이 문자열 열 이름이 아니라 JET_COLUMNID 대한 포인터임을 나타냅니다.
JET_ColInfoList	pvResult 는 JET_COLUMNLIST 구조체로 해석됩니다. 이 함수가 성공하면 구조체가 적절한 값으로 채워집니다. 임시 테이블이 열리고 JET_COLUMNLIST 구조체의 tableid 멤버로 식별됩니다. JetCloseTable을 사용하여 테이블을 닫아야 합니다. 이 함수가 실패하면 구조체에 정의되지 않은 데이터가 포함됩니다.
JET_ColInfoListCompact	JET_ColInfoList 동일합니다.
JET_ColInfoListSortColumnid	JET_ColInfoList 동일; 그러나 결과 테이블은 열 이름 대신 columnid로 정렬됩니다.
JET_ColInfoSysTabCursor	JET_ColInfoSysTabCursor 더 이상 사용되지 않으며 사용은 JET_errFeatureNotAvailable 반환합니다.
JET_ColInfoBaseByColId	JET_ColInfoBase 마찬가지로 pvResult 는 JET_COLUMNBASE 해석됩니다. 단, 이 InfoLevel 은 요청된 열(szColumName)이 문자열 열 이름이 아니라 JET_COLUMNID 대한 포인터임을 나타냅니다. Windows Vista: 이 값은 Windows Vista에 도입되었습니다.
JET_ColInfoGrbitNonDerivedColumnsOnly	파생되지 않은 열만 반환합니다(테이블이 템플릿에서 파생된 경우). 기본 InfoLevel이 JET_ColInfoList 경우 이 값은 논리적으로 또는 InfoLevel 에 들어갈 수 있습니다. Windows Vista: 이 값은 Windows Vista에 도입되었습니다.
JET_ColInfoGrbitMinimalInfo	각 열의 열 이름과 columnid만 반환합니다. 기본 InfoLevel이 JET_ColInfoList 경우 이 값은 논리적으로 또는 InfoLevel 에 들어갈 수 있습니다. Windows Vista: 이 값은 Windows Vista에 도입되었습니다.
JET_ColInfoGrbitSortByColumnid	반환된 열 목록을 columnid로 정렬합니다(기본값은 열 이름을 기준으로 목록을 정렬하는 것입니다). 기본 InfoLevel이 JET_ColInfoList 경우 이 값은 논리적으로 또는 InfoLevel 에 들어갈 수 있습니다. Windows Vista: 이 값은 Windows Vista에 도입되었습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errColumnNotFound	테이블에 szColumnName 이라는 열을 찾을 수 없습니다.
JET_errFeatureNotAvailable	잘못된 InfoLevel 이 지정되었습니다.
JET_errInvalidName	다음과 같은 경우 이 오류를 반환할 수 있습니다. szTableName에 대한 잘못된 이름이 지정되었습니다. szColumnName에 대한 잘못된 이름이 지정되었습니다.
JET_errInvalidParameter	다음과 같은 경우 이 오류를 반환할 수 있습니다. 잘못된 InfoLevel 이 지정되었습니다. NULL szTableName 이 전달되었습니다. 버퍼가 너무 작습니다.

설명

JetGetTableColumnInfo 및 JetGetColumnInfo 는 모두 열에 대한 정보를 검색합니다. 두 테이블 간의 차이점은 테이블이 식별되는 방식입니다.

JetGetTableColumnInfo 는 tableid로 테이블을 식별합니다.
JetGetColumnInfo 는 dbid 및 szTableName 조합으로 테이블을 식별합니다.

JET_ColInfoList, JET_ColInfoListSortColumnid 또는 JET_ColInfoListCompact 사용하여 데이터를 검색할 때 임시 테이블이 열립니다. 임시 테이블에는 데이터가 포함되고 JET_COLUMNLIST 구조에는 임시 테이블을 트래버스하기에 충분한 정보가 포함되어 있습니다. 임시 테이블은 JetCloseTable을 사용하여 닫아야 합니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.
유니코드	JetGetColumnInfoW(유니코드) 및 JetGetColumnInfoA(ANSI)로 구현됩니다.

참고 항목

오류 처리 매개 변수
확장 가능한 스토리지 엔진 오류
JET_COLUMNBASE
JET_COLUMNDEF
JET_COLUMNID
JET_COLUMNLIST
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCloseTable
JetGetTableColumnInfo

JetGetColumnInfo 함수