JetGetTableColumnInfo 함수
적용 대상: Windows | Windows Server
JetGetTableColumnInfo 함수
JetGetTableColumnInfo 함수는 테이블 열에 대한 정보를 검색합니다.
JET_ERR JET_API JetGetTableColumnInfo(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName,
__out void* pvResult,
__in unsigned long cbMax,
__in unsigned long InfoLevel
);
매개 변수
sesid
API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.
tableid
정보를 가져올 열이 들어 있는 테이블입니다.
szColumnName
정보를 가져올 열의 이름입니다.
pvResult
정보를 받을 버퍼에 대한 포인터입니다. 버퍼의 형식은 InfoLevel에 따라 달라집니다. 버퍼를 적절하게 정렬하도록 호출자를 구성해야 합니다.
cbMax
pvResult로 전달된 버퍼의 크기(바이트)입니다.
InfoLevel
szColumnName으로 지정된 열에 대해 검색할 정보 형식입니다. pvResult에 저장된 데이터의 형식은 InfoLevel에 따라 달라집니다. 임시 테이블의 스키마는 JET_COLUMNLIST 참조하세요.
JET_ColInfoListSortColumnid 임시 테이블을 columnid별로 정렬합니다.
JET_ColInfoListCompact 출력을 압축합니다. 압축 출력에 대한 자세한 내용은 JET_COLUMNLIST 참조하세요.
이 매개 변수에 대해 다음 옵션을 설정할 수 있습니다.
값 |
의미 |
|---|---|
JET_ColInfo |
pvResult 는 JET_COLUMNDEF 해석되고 JET_COLUMNDEF 구조체의 필드는 적절하게 채워집니다. JET_ColInfo 및 JET_ColInfoByColid 모두 동일한 정보를 검색합니다. |
JET_ColInfoBase |
pvResult 는 JET_COLUMNBASE 구조체로 해석됩니다. 이는 JET_COLUMNDEF 구조체와 비슷합니다. 이 함수가 성공하면 구조체가 적절한 값으로 채워집니다. 이 함수가 실패하면 구조체에 정의되지 않은 데이터가 포함됩니다. |
JET_ColInfoByColid |
pvResult 는 JET_COLUMNDEF 해석됩니다. 이 InfoLevel 은 요청된 열(szColumName)이 문자열 열 이름이 아니라 JET_COLUMNID 대한 포인터임을 나타냅니다. JET_ColInfo 및 JET_ColInfoByColid 모두 동일한 정보를 검색합니다. |
JET_ColInfoList |
pvResult 는 JET_COLUMNLIST 구조체로 해석됩니다. 이 함수가 성공하면 구조체가 적절한 값으로 채워집니다. 임시 테이블이 열리고 JET_COLUMNLISTtableid 멤버로 식별됩니다. JetCloseTable을 사용하여 테이블을 닫아야 합니다. 이 함수가 실패하면 구조체에 정의되지 않은 데이터가 포함됩니다. |
JET_ColInfoListCompact |
pvResult 는 JET_COLUMNLIST 구조체로 해석됩니다. 이 함수가 성공하면 구조체가 적절한 값으로 채워집니다. 임시 테이블이 열리고 JET_COLUMNLISTtableid 멤버로 식별됩니다. JetCloseTable을 사용하여 테이블을 닫아야 합니다. 이 함수가 실패하면 구조체에 정의되지 않은 데이터가 포함됩니다. |
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 |
이 오류는 다음과 같은 경우 반환될 수 있습니다.
|
JET_errInvalidParameter |
이 오류는 다음과 같은 경우 반환될 수 있습니다.
|
설명
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 필요합니다. |
유니코드 |
JetGetTableColumnInfoW(유니코드) 및 JetGetTableColumnInfoA(ANSI)로 구현됩니다. |
참고 항목
확장 가능한 스토리지 엔진 오류
매개 변수 처리 오류
JET_COLUMNBASE
JET_COLUMNDEF
JET_COLUMNID
JET_COLUMNLIST
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetCloseTable
JetGetColumnInfo
JetGetTableColumnInfo