JetGetObjectInfo 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetGetObjectInfo 함수

JetGetObjectInfo 함수는 데이터베이스 개체에 대한 정보를 검색합니다. 현재 테이블만 지원됩니다. JetGetTableInfo 를 사용하여 JetGetObjectInfo보다 더 많은 정보를 가져올 수 있습니다.

    JET_ERR JET_API JetGetObjectInfo(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          JET_OBJTYP objtyp,
      __in_opt      const tchar* szContainerName,
      __in_opt      const tchar* szObjectName,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

매개 변수

sesid

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

dbid

정보를 검색할 데이터베이스입니다.

objtyp

검색할 정보가 포함된 개체입니다. 현재는 JET_objtypNil 및 JET_objtypTable만 지원되며 둘 다 동일하게 작동합니다. 테이블만 검색됩니다.

szContainerName

이 매개 변수는 나중에 사용하기 위해 예약되고 NULL을 전달합니다. 정보를 검색할 개체 형식의 이름입니다.

szObjectName

검색할 정보가 포함된 개체의 이름입니다. InfoLevel이 JET_ObjInfoList 또는 JET_ObjInfoListNoStats 옵션을 사용하여 모든 개체 목록을 검색하는 경우 이 값은 NULL 또는 빈 문자열이어야 합니다.

현재는 테이블 이름만 지원됩니다.

pvResult

지정된 정보를 수신하는 버퍼에 대한 포인터입니다.

버퍼 크기(바이트)는 cbMax로 전달됩니다. 실패 시 pvResult 의 콘텐츠는 정의되지 않습니다.

pvResult에 저장된 정보는 InfoLevel에 따라 달라집니다.

cbMax

pvResult에 전달된 버퍼의 크기(바이트)입니다.

InfoLevel

지정된 개체에 대해 검색할 정보 유형을 지정합니다. pvResult가 해석되는 방식에 영향을 줍니다.

이 매개 변수에 대해 다음 옵션을 설정할 수 있습니다.

값	의미
JET_ObjInfo	pvResult 는 JET_OBJECTINFO 구조체로 해석됩니다. JET_OBJECTINFO 구조체는 szObjectName에서 명명된 개체와 관련된 정보로 채워집니다. 호출자가 개체의 레코드 및 페이지 수를 알고 싶지 않은 경우 통계가 포함되지 않기 때문에 더 빠를 수 있는 JET_ObjInfoNoStats 정보 수준을 사용하는 것이 좋습니다.
JET_ObjInfoList	pvResult 는 JET_OBJECTLIST 구조체로 해석됩니다. 모든 개체에 대한 정보가 검색됩니다. 임시 테이블이 만들어지고 임시 테이블을 트래버스하는 데 필요한 정보는 JET_OBJECTLIST 구조에 설명되어 있습니다. 자세한 내용은 JET_OBJECTLIST 참조하세요. 호출자가 개체의 레코드 및 페이지 수를 알고 싶지 않은 경우 더 빠른 JET_ObjInfoListNoStats 사용하는 것이 좋습니다.
JET_ObjInfoListACM	더 이상 사용되지 않으며 현재 지원되지 않습니다.
JET_ObjInfoListNoStats	pvResult 는 JET_OBJECTLIST 구조체로 해석됩니다. 모든 개체에 대한 정보가 검색됩니다. 임시 테이블이 만들어지고 임시 테이블을 트래버스하는 데 필요한 정보는 JET_OBJECTLIST 구조에 설명되어 있습니다. 자세한 내용은 JET_OBJECTLIST 참조하세요. 레코드 수(columnidcRecord) 및 페이지(columnidcPage)를 보고하는 열이 업데이트되지 않는다는 점을 제외하고 JET_ObjInfoListNoStats JET_ObjInfoList 동일합니다.
JET_ObjInfoMax	pvResult 는 JET_OBJECTINFO 해석됩니다. 개체의 최대 크기는 페이지에 있습니다. 현재는 테이블만 반환됩니다.
JET_ObjInfoNoStats	pvResult 는 JET_OBJECTINFO 해석됩니다. szObjectName에 지정된 개체에 대한 정보만 검색됩니다. JET_OBJECTINFO 구조체는 szObjectName에서 명명된 개체와 관련된 정보로 채워집니다. JET_ObjInfoNoStats 레코드 및 페이지 수를 보고하는 필드가 0으로 설정된다는 점을 제외하고 JET_ObjInfo 동일합니다.
JET_ObjInfoRulesLoaded	더 이상 사용되지 않으며 현재 지원되지 않습니다.
JET_ObjInfoSysTabCursor	더 이상 사용되지 않으며 현재 지원되지 않습니다.
JET_ObjInfoSysTabReadOnly	더 이상 사용되지 않으며 현재 지원되지 않습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errBufferTooSmall	cbMax에 지정된 버퍼의 크기가 너무 작아 원하는 정보를 보유할 수 없습니다.
JET_errInvalidName	szObjectName 또는 szContainerName에 잘못된 이름이 지정되었습니다.
JET_errInvalidParameter	잘못된 매개 변수가 지정되었습니다. 잘못된 수준이 InfoLevel에 전달되었을 수 있습니다.

설명

JetGetObjectInfo가 임시 테이블(예: JET_ObjInfoList 또는 JET_ObjInfoNoStats)을 성공적으로 만드는 경우 호출자는 JetCloseTable을 사용하여 임시 테이블을 닫습니다.

JetGetObjectInfo 는 현재 테이블에 대한 정보 검색만 지원합니다.

요구 사항

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

참고 항목

JET_ERR
JET_GRBIT
JET_OBJTYP
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetCloseTable
JetGetTableInfo

JetGetObjectInfo 함수