JetGetTableInfo 함수
적용 대상: Windows | Windows Server
JetGetTableInfo 함수
JetGetTableInfo 함수는 데이터베이스의 테이블에 대한 다양한 정보를 검색합니다.
JET_ERR JET_API JetGetTableInfo(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out void* pvResult,
__in unsigned long cbMax,
__in unsigned long InfoLevel
);
매개 변수
sesid
API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.
tableid
정보가 적용되는 테이블입니다.
pvResult
정보를 받을 버퍼에 대한 포인터입니다. 버퍼의 형식은 InfoLevel에 따라 달라집니다. 버퍼를 적절하게 맞추는 것은 호출자의 책임입니다.
cbMax
pvResult로 전달된 버퍼의 크기(바이트)입니다.
InfoLevel
tableid로 지정된 테이블에 대해 검색할 정보 유형입니다. pvResult에 저장된 데이터의 형식은 InfoLevel에 따라 달라집니다.
이 매개 변수에 대해 다음 옵션을 설정할 수 있습니다.
값 |
의미 |
---|---|
JET_TblInfo |
pvResult 는 JET_OBJECTINFO 구조체로 해석됩니다. 메서드가 성공하면 JET_OBJECTINFO 구조체가 적절한 데이터로 채워집니다. 실패하면 콘텐츠가 정의되지 않습니다. |
JET_TblInfoDbid |
pvResult 는 두 JET_DBID 개체의 배열로 처리됩니다. 테이블을 소유하는 데이터베이스의 데이터베이스 식별자는 이 배열에 두 번 저장됩니다. |
JET_TblInfoDumpTable |
JET_TblInfoDumpTable 더 이상 사용되지 않습니다. API는 JET_errFeatureNotAvailable 반환합니다. |
JET_TblInfoName |
JET_TblInfoName 테이블의 이름을 검색하고 pvResult에 저장합니다. 버퍼가 너무 작으면 동작이 정의되지 않습니다. |
JET_TblInfoMostMany |
JET_TblInfoMostMany 테이블의 이름을 검색하고 pvResult에 저장합니다. 버퍼가 너무 작으면 동작이 정의되지 않습니다. |
JET_TblInfoOLC |
JET_TblInfoOLC 더 이상 사용되지 않습니다. API는 JET_errFeatureNotAvailable 반환합니다. |
JET_TblInfoRvt |
JET_TblInfoRvt 더 이상 사용되지 않습니다. API는 JET_errQueryNotSupported 반환합니다. |
JET_TblInfoResetOLC |
JET_TblInfoResetOLC 더 이상 사용되지 않습니다. API는 JET_errFeatureNotAvailable 반환합니다. |
JET_TblInfoSpaceAlloc |
pvResult 는 다음 두 개의 ULONG 배열로 해석됩니다.
|
JET_TblInfoSpaceAvailable |
pvResult 는 ULONG으로 해석됩니다. ULONG은 테이블에서 사용할 수 있는 페이지 수, 인덱스 및 긴 값 트리의 합계입니다. |
JET_TblInfoSpaceOwned |
pvResult 는 ULONG으로 해석됩니다. ULONG은 테이블이 소유한 페이지 수(해당 인덱스, 긴 값 트리 및 그 안에 있는 사용 가능한 페이지 포함)의 합계입니다. |
JET_TblInfoSpaceUsage |
API의 동작은 API에 전달되는 버퍼의 규모에 따라 달라집니다. 두 cbMax 값은 적어도 ( 2 * sizeof( ULONG ) )이어야 합니다.
|
JET_TblInfoTemplateTableName |
pvResult 는 문자열 버퍼로 해석됩니다. 버퍼는 종료 NULL을 포함하여 최소 JET_cbNameMost + 1이어야 합니다. 테이블이 파생 테이블인 경우 버퍼는 파생 테이블이 DDL을 상속한 테이블의 이름으로 채워집니다. 테이블이 파생 테이블이 아닌 경우 버퍼는 빈 문자열을 만듭니다. |
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errBufferTooSmall |
버퍼가 너무 작습니다. |
JET_errFeatureNotAvailable |
사용되지 않는 InfoLevel 이 지정되었습니다. |
JET_errInvalidBufferSize |
버퍼가 올바른 크기가 아니었습니다. |
JET_errInvalidOperation |
전달된 테이블은 임시 테이블이었고, 요청된 InfoLevel 은 임시 테이블에 대해 검색할 수 없습니다. |
JET_errObjectNotFound |
전달된 테이블은 임시 테이블이었고, 요청된 InfoLevel 은 임시 테이블에 대해 검색할 수 없습니다. |
JET_errQueryNotSupported |
InfoLevel은 지원되지 않습니다. |
JET_errTableInUse |
테이블이 다른 데이터베이스 작업에서 사용되고 있습니다. |
JET_errTableLocked |
테이블은 다른 데이터베이스 작업에 의해 잠깁니다. |
JET_wrnTableInUseBySystem |
시스템에서 테이블이 사용되고 있습니다. 이 경고는 심각하지 않습니다. |
설명
일부 정보는 임시 테이블에 유효하지 않습니다( JetOpenTempTable 참조).
테이블 통계에는 레코드 수와 클러스터형 인덱스의 페이지 수(즉, 레코드 데이터가 포함된 인덱스)가 포함됩니다. 인덱스 통계는 JetGetIndexInfo 또는 JetGetTableIndexInfo 를 사용하여 이름으로 개별적으로 액세스 됩니다.
요구 사항
요구 사항 | 값 |
---|---|
클라이언트 |
Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다. |
서버 |
Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다. |
머리글 |
Esent.h에서 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
유니코드 |
JetGetTableInfoW(유니코드) 및 JetGetTableInfoA(ANSI)로 구현됩니다. |
참고 항목
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JetGetIndexInfo
JetGetObjectInfo
JetGetTableIndexInfo
JetOpenTempTable