JetGetDatabaseFileInfo 함수

적용 대상: Windows | Windows Server

JetGetDatabaseFileInfo 함수

JetGetDatabaseFileInfo 함수는 데이터베이스에 대한 다양한 유형의 정보를 검색합니다. 데이터베이스가 연결되거나 온라인 상태이거나( JetGetDatabaseInfo 사용) 데이터베이스 또는 데이터베이스 엔진이 오프라인 상태인 동안( JetGetDatabaseFileInfo 사용) 이 API를 호출할 수 있습니다.

    JET_ERR JET_API JetGetDatabaseFileInfo(
      __in          const tchar* szDatabaseName,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

매개 변수

szDatabaseName

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

pvResult

지정된 정보를 받을 버퍼에 대한 포인터입니다. 버퍼의 크기(바이트)는 cbMax로 전달됩니다.

이 함수가 실패하면 pvResult 의 내용이 정의되지 않습니다.

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

cbMax

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

InfoLevel

InfoLevel 은 지정된 데이터베이스에 대해 검색해야 하는 정보 유형을 지정합니다. pvResult가 해석되는 방식에 영향을 줍니다. 일부 InfoLevel 개체는 API의 오프라인(JetGetDatabaseFileInfo) 또는 온라인(JetGetDatabaseInfo) 버전에서만 사용할 수 있습니다.

제공된 pvResult 버퍼가 너무 작으면 InfoLevel에 따라 JET_errInvalidBufferSize 또는 JET_errBufferTooSmall 반환됩니다.

의미

JET_DbInfoFilesize

pvResult 는 QWORD(8바이트)로 해석됩니다. 데이터베이스의 크기를 바이트 단위로 반환합니다.

JET_DbInfoUpgrade

pvResultJET_DBINFOUPGRADE 해석됩니다. JET_DBINFOUPGRADE 구조체는 지정된 데이터베이스와 관련된 정보로 채워집니다.

JET_DbInfoMisc

pvResultJET_DBINFOMISC 해석됩니다. JET_DBINFOMISC 구조체는 지정된 데이터베이스와 관련된 정보로 채워집니다.

JET_DbInfoDBInUse

pvResult 는 BOOL(4바이트)로 해석됩니다. 이렇게 하면 데이터베이스 엔진에 현재 열려 있는 데이터베이스 또는 연결된 데이터베이스가 있는지 여부를 반환합니다.

Windows XP: 이 값은 Windows XP에 도입되었습니다.

JET_DbInfoPageSize

pvResult 는 부호 없는 긴 것으로 해석됩니다. 그러면 데이터베이스의 페이지 크기가 바이트 단위로 반환됩니다.

Windows XP: 이 값은 Windows XP에 도입되었습니다.

JET_DbInfoCp

이러한 InfoLevels 는 아직 지원되지 않으며 기본값을 반환합니다. 이러한 InfoLevels를 사용하지 마세요.

JET_DbInfoCountry

이러한 InfoLevels 는 아직 지원되지 않으며 기본값을 반환합니다. 이러한 InfoLevels를 사용하지 마세요.

JET_DbInfoCollate

JET_DbInfoCp 동일합니다.

JET_DbInfoIsam

이러한 InfoLevels 는 더 이상 사용되지 않으며 현재 지원되지 않습니다. 이러한 InfoLevels를 사용하지 마세요.

JET_DbInfoConnect

JET_DbInfoIsam 동일합니다.

JET_DbInfoFileType

Windows Vista: InfoLevel 값은 Windows Vista에 도입되었습니다.

pvResult 는 DWORD에 대한 포인터로 처리됩니다. 엔진에서 이 것으로 간주하는 파일의 종류를 나타내는 열거형 값을 반환합니다. 파일 형식은 다음 표에 나와 있습니다. 이러한 유형의 파일 및 엔진에 대한 사용에 대한 자세한 내용은 Extensible Storage Engine Files를 참조하세요.

의미

JET_filetypeUnknown

파일 형식을 알 수 없거나 ESE 파일 형식이 아닙니다.

JET_filetypeDatabase

파일이 데이터베이스 파일입니다.

JET_filetypeLog

파일이 트랜잭션 로그 파일입니다.

JET_filetypeCheckpoint

이 파일은 검사점 파일입니다.

JET_filetypeTempDatabase

파일은 임시 데이터베이스 파일입니다.

반환 값

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

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

JET_errFeatureNotAvailable

요청한 InfoLevel 이 JET_DbInfoIsam. 이는 지원되지 않습니다.

JET_errBufferTooSmall

cbMax에 지정된 버퍼가 너무 작아서 원하는 정보를 사용할 수 없습니다.

JET_errInvalidBufferSize

cbMax에 지정된 버퍼가 원하는 정보에 대한 올바른 크기가 아닙니다.

JET_errInvalidParameter

제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 여러 매개 변수 값의 조합으로 예기치 않은 결과가 발생했습니다. 제공된 DBID가 유효한(연결된) 데이터베이스가 아닌 경우 JetGetDatabaseInfo 에서 이 오류가 반환됩니다. 이 오류는 해당 버전의 함수에서 요청한 InfoLevel이 지원되지 않는 경우 JetGetDatabaseFileInfoJetGetDatabaseInfo에서 반환됩니다.

이 함수가 성공하면 요청된 데이터가 출력 버퍼에 반환됩니다.

이 함수가 실패하면 출력 버퍼가 정의되지 않은 상태가 됩니다.

요구 사항

클라이언트

Windows Vista, Windows XP 또는 Windows 2000 Professional 필요합니다.

Server

Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.

머리글

Esent.h에서 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

유니코드

JetGetDatabaseFileInfoW(유니코드) 및 JetGetDatabaseFileInfoA(ANSI)로 구현됩니다.

참고 항목

JET_ERR
JET_DBINFOMISC
JET_DBINFOUPGRADE
JetGetDatabaseInfo