JetGetDatabaseFileInfo 함수

아티클
06/13/2023

적용 대상: 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 개체는 오프라인(JetGetDatabaseFileInfo) 또는 온라인(JetGetDatabaseInfo) 버전의 API에서만 사용할 수 있습니다.

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

JET_DbInfoFilesize

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

JET_DbInfoUpgrade

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

JET_DbInfoMisc

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

JET_DbInfoDBInUse

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

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

JET_DbInfoPageSize

pvResult 는 서명되지 않은 long으로 해석됩니다. 그러면 데이터베이스의 페이지 크기가 바이트 단위로 반환됩니다.

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

JET_DbInfoCp

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

JET_DbInfoCountry

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

JET_DbInfoCollate

JET_DbInfoCp 동일합니다.

JET_DbInfoIsam

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

JET_DbInfoConnect

JET_DbInfoIsam 동일합니다.

JET_DbInfoFileType

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

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

값	의미
JET_filetypeUnknown	파일 형식을 알 수 없거나 ESE 파일 형식이 아닙니다.
JET_filetypeDatabase	파일은 데이터베이스 파일입니다.
JET_filetypeLog	파일은 트랜잭션 로그 파일입니다.
JET_filetypeCheckpoint	파일이 검사점 파일입니다.
JET_filetypeTempDatabase	파일은 임시 데이터베이스 파일입니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errFeatureNotAvailable	요청한 InfoLevel 이 JET_DbInfoIsam. 이는 지원되지 않습니다.
JET_errBufferTooSmall	cbMax에 지정된 버퍼가 너무 작아서 원하는 정보를 사용할 수 없습니다.
JET_errInvalidBufferSize	cbMax에 지정된 버퍼는 원하는 정보에 대한 올바른 크기가 아닙니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 여러 매개 변수 값의 조합으로 예기치 않은 결과가 발생했습니다. 제공된 DBID가 유효한(연결된) 데이터베이스가 아닌 경우 JetGetDatabaseInfo 에서 이 오류가 반환됩니다. 이 오류는 해당 버전의 함수에서 InfoLevel이 지원되지 않는 경우 JetGetDatabaseFileInfo 및 JetGetDatabaseInfo에서 반환됩니다.

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

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

요구 사항

클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	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

JetGetDatabaseFileInfo 함수