可扩展存储引擎错误

  • 项目

适用于： 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

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

另请参阅

错误处理参数

可扩展存储引擎错误代码

JET_ERR