共用方式為

JetGetInstanceInfo 函式

  • 發行項

適用于： Windows |Windows Server

JetGetInstanceInfo 函式

JetGetInstanceInfo函式會擷取執行中實例的相關資訊。

Windows XP：JetGetInstanceInfo 是在 Windows XP 中引進。

    JET_ERR JET_API JetGetInstanceInfo(
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo
    );

參數

pcInstanceInfo

緩衝區的指標，將接收 儲存在 paInstanceInfo中的元素數目。

paInstanceInfo

緩衝區的指標，將接收結構陣列之第一個專案的位址。

傳回值

此函式會傳回具有下列其中一個傳回碼 的 JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊，請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。

傳回碼

Description

JET_errSuccess

作業已成功完成。

JET_errInvalidParameter

提供的其中一個參數包含非預期的值，或包含與另一個參數的值結合時沒有意義的值。 JetGetInstanceInfo會在下列情況下傳回此錯誤：

  • pcInstanceInfo 或 paInstanceInfo 為 Null。

JET_errOutOfMemory

記憶體不足，無法處理要求。

備註

資料庫引擎會配置 JET_INSTANCE_INFO 結構的陣列。 呼叫端負責使用 JetFreeBuffer釋放此記憶體。

如果沒有作用中的實例， JetGetInstanceInfo 會傳回JET_errSuccess， 而 pcInstanceInfo 會接收值為 0。

規格需求

需求 值

用戶端

需要 Windows Vista 或 Windows XP。

Server

需要 Windows Server 2008 或 Windows Server 2003。

標頭

在 Esent.h 中宣告。

程式庫

使用 ESENT.lib。

Dll

需要ESENT.dll。

Unicode

實作為 JetGetInstanceInfoW (Unicode) 和 JetGetInstanceInfoA (ANSI) 。

另請參閱

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer