JetGetErrorInfoW 函式

適用于： Windows |Windows Server

JetGetErrorInfoW 函式

JetGetErrorInfoW函式BAS_資料庫引擎。

注意：本檔是以可延伸儲存引擎的初步版本為基礎。 此資訊可能隨時變更。

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

參數

pvCoNtext

需要擴充錯誤資訊的內容或錯誤值。 傳入的值取決於 InfoLevel 參數值。

pvResult

將接收資訊的緩衝區指標。 緩衝區的類型取決於 InfoLevel 參數值。 呼叫端必須設定為適當地對齊緩衝區。

cbMax

傳入之 pvResult 結構的大小上限。

InfoLevel

將會針對錯誤資訊/內容擷取的資訊類型是由 pvCoNtext 參數所指定。 儲存在 pvResult中的資料格式取決於InfoLevel。

下表列出此參數的可能值。

值	意義
JET_ErrorInfoSpecificErr	pvCoNtext 會解譯為 JET_ERR/錯誤碼， pvResult 會解譯為 JET_ERRINFOBASIC_W，並適當地填入 JET_ERRINFOBASIC_W 結構的欄位。

grbit

保留的。

傳回值

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

傳回碼	描述
JET_errSuccess	作業已成功完成。
JET_errInvalidParameter	提供的其中一個參數包含非預期的值，或包含與另一個參數值結合時不有意義的值。 當發生下列情況時， JetGetErrorInfo 可能會發生此問題： 指定的 InfoLevel 參數值無效。 指定的 grbit 值無效。 指定的 pvResult 參數緩衝區 cbMax 值小於這個 InfoLevel 參數輸出所需的大小。 對於 InfoLevel = JET_ErrorInfoSpecificErr，傳入 的JET_ERR 值對引擎而言是未知的。
JET_errDisabledFunctionality	如果此視窗的 SKU 不支援此函式，將會傳回此錯誤。

成功時，適用于所要求錯誤內容/值的輸出緩衝區將會設定為所要求的擴充錯誤資訊。

失敗時，輸出緩衝區的狀態將會未定義。

備註

JET_ERRINFOBASIC_W函式和JET_ERRCAT常數群組包含InfoLevel = JET_ErrorInfoSpecificErr 傳回之擴充錯誤資訊的相關檔。

規格需求

需求	值
用戶端	需要Windows 8。
Server	需要Windows 8伺服器。
標頭	在 Esent.h 中宣告。
程式庫	使用 ESENT.lib。
Dll	需要ESENT.dll。
Unicode	注意：只會實作 JetGetErrorInfoW (Unicode) 。 此 API 沒有 A (ANSI) 版本。