可扩展存储引擎错误
适用于: 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
有关配置系统参数以处理错误的信息,请参阅 错误处理参数。