共用方式為

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 物件只能在離線 (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 個位元組) 。 這會傳回資料庫引擎目前是否有任何開啟或附加的資料庫。

Windowsxp： 此值是在 Windows XP 中引進。

JET_DbInfoPageSize

pvResult 將會解譯為不帶正負號的 long。 這會以位元組為單位傳回資料庫的分頁大小。

Windowsxp： 此值是在 Windows XP 中引進。

JET_DbInfoCp

尚不支援這些 InfoLevels 並傳回預設值。 請勿使用這些 InfoLevels。

JET_DbInfoCountry

尚不支援這些 InfoLevels 並傳回預設值。 請勿使用這些 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 錯誤的詳細資訊，請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。

傳回碼

Description

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。

Server

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

標頭

在 Esent.h 中宣告。

程式庫

使用 ESENT.lib。

Dll

需要ESENT.dll。

Unicode

實作為 JetGetDatabaseFileInfoW (Unicode) 和 JetGetDatabaseFileInfoA (ANSI) 。

另請參閱

JET_ERR
JET_DBINFOMISC
JET_DBINFOUPGRADE
JetGetDatabaseInfo