可扩展存储引擎错误

适用于:Windows |Windows服务器

可扩展存储引擎错误

可扩展存储引擎 (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

有关为错误处理配置系统参数的信息,请参阅 错误处理参数

另请参阅

错误处理参数

可扩展存储引擎错误代码

JET_ERR