可扩展存储引擎错误

适用于: Windows |Windows服务

可扩展存储引擎错误

可扩展存储引擎 (ESE) API 返回的所有可能的错误都由JET_ERR数据类型定义。 有关为此 API 定义的错误标志的列表,请参阅可扩展存储引擎错误代码

在整个 ESE API 文档中,只记录最重要的错误。 这些错误通常表示 API 使用错误或非常重要的错误条件。 请注意,这些 ESE Api 中的任何一个也可能返回未为每个 API 记录的其他错误。 在这些情况下,调用方应简单地处理错误,因为它们会处理 API 返回的任何其他错误。 然后,特定错误值可用于诊断目的,例如跟踪。

通常,大于零的值应解释为警告,值为零时应解释为成功,而小于零的值应解释为错误。 这些值中没有其他模式 (例如,应用程序应该依赖) 值范围。

当 ESE 遇到一些更严重的错误时,它会创建一个包含有关错误的详细信息的事件日志项。 事件日志参数可以控制日志记录级别。

某些应用程序需要能够以 Hresult 的形式返回 JET_ERR。 下面的 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