可扩展存储引擎错误
适用于: Windows |Windows Server
可扩展存储引擎错误
可扩展存储引擎 (ESE) API 返回的所有可能错误都由 JET_ERR 数据类型定义。 有关为此 API 定义的错误标志的列表,请参阅 可扩展存储引擎错误代码。
在整个 ESE API 文档中,仅记录最重要的错误。 这些错误通常表示 API 使用错误或非常重要的错误条件。 请注意,这些 ESE API 中的任何一个都可能返回未为每个 API 记录的其他错误。 在这些情况下,调用方应像处理 API 返回的任何其他错误一样处理错误。 然后,特定错误值可用于诊断目的,例如跟踪。
通常,大于零的值应解释为警告,零值应解释为成功,小于零的值应解释为错误。 例如,这些值中没有其他模式 (应用程序应依赖) 的值范围。
当 ESE 遇到一些更严重的错误时,它会创建一个事件日志条目,其中包含有关错误的详细信息。 日志记录级别可由 事件日志参数控制。
某些应用程序需要能够将 JET_ERR作为 HRESULT 返回。 以下 C++ 示例演示如何进行该转换:
#ifndef FACILITY_JET_ERR
#define FACILITY_JET_ERR 0xE5E
#endif
#ifndef HRESULT_FROM_JET_ERR
#define HRESULT_FROM_JET_ERR( __err )
(
( __err ) == JET_errSuccess ?
S_OK :
(
( __err ) == JET_errOutOfMemory ?
E_OUTOFMEMORY :
MAKE_HRESULT
(
(
( __err ) < 0 ?
SEVERITY_ERROR :
SEVERITY_SUCCESS
),
FACILITY_JET_ERR,
(
( __err ) < 0 ?
-( __err ) :
( __err )
)
& 0xFFFF
)
)
)
#endif
有关为错误处理配置系统参数的信息,请参阅 错误处理参数。