JetGetTableInfo 함수

아티클
06/13/2023

적용 대상: 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 배열로 해석됩니다. 첫 번째 ULONG 은 테이블의 페이지 수입니다. 두 번째 ULONG 은 테이블에 대한 페이지의 대상 밀도입니다.
JET_TblInfoSpaceAvailable	pvResult 는 ULONG으로 해석됩니다. ULONG은 테이블에서 사용할 수 있는 페이지 수, 인덱스 및 긴 값 트리의 합계입니다.
JET_TblInfoSpaceOwned	pvResult 는 ULONG으로 해석됩니다. ULONG은 테이블이 소유한 페이지 수(해당 인덱스, 긴 값 트리 및 그 안에 있는 사용 가능한 페이지 포함)의 합계입니다.
JET_TblInfoSpaceUsage	API의 동작은 API에 전달되는 버퍼의 규모에 따라 달라집니다. 두 cbMax 값은 적어도 ( 2 * sizeof( ULONG ) )이어야 합니다. cbMax가 ( 2 * sizeof( ULONG )인 경우 pvResult는 두 개의 ULONG 배열로 해석됩니다. 첫 번째 ULONG 은 테이블의 소유 익스텐트 수입니다. 두 번째 ULONG 은 테이블의 사용 가능한 익스텐트 수입니다. pvResult 는 다음의 배열로 해석됩니다. 첫 번째 ULONG 은 테이블의 소유 익스텐트 수입니다. 두 번째 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

JetGetTableInfo 함수