Errores del motor de almacenamiento extensible

  • Artículo

Se aplica a: Windows | Windows Server

Errores del motor de almacenamiento extensible

Todos los posibles errores devueltos por la API del motor de almacenamiento extensible (ESE) se definen mediante el tipo de datos JET_ERR . Para obtener una lista de las marcas de error definidas para esta API, consulte Códigos de error del motor de almacenamiento extensible.

A lo largo de la documentación de la API de ESE, solo se documentan los errores más importantes. Estos errores suelen representar errores de uso de API o condiciones de error muy importantes. Tenga en cuenta que cualquiera de estas API de ESE también puede devolver otros errores que no están documentados para cada API. En estos casos, el autor de la llamada simplemente debe controlar el error, ya que cualquier otro error devuelto por la API. A continuación, se puede usar el valor de error específico para fines de diagnóstico, como el seguimiento.

En general, un valor mayor que cero debe interpretarse como una advertencia, un valor de cero debe interpretarse como correcto y un valor menor que cero debe interpretarse como un error. Una aplicación no debe confiar en ningún otro patrón de estos valores (por ejemplo, intervalos de valores).

Cuando ESE encuentra algunos de los errores más graves, crea una entrada de registro de eventos que contiene detalles sobre los errores. Los parámetros del registro pueden controlar el nivel de registro.

Algunas aplicaciones requieren la capacidad de devolver JET_ERRs como HRESULT. En el ejemplo de C++ siguiente se muestra cómo realizar esa conversión:

    #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

Para obtener información sobre cómo configurar parámetros del sistema para el control de errores, vea Parámetros de control de errores.

Consulte también

Parámetros de control de errores

Códigos de error del motor de almacenamiento extensible

JET_ERR