Erweiterbare Speicher-Engine-Fehler

  • Artikel

Gilt für: Windows | Windows Server

Erweiterbare Speicher-Engine-Fehler

Alle möglichen Fehler, die von der ESE-API (Extensible Storage Engine) zurückgegeben werden, werden durch den JET_ERR Datentyp definiert. Eine Liste der Fehlerflags, die für diese API definiert sind, finden Sie unter Fehlercodes für erweiterbare Speicher-Engine.

In der dokumentation der ESE-API werden nur die wichtigsten Fehler dokumentiert. Diese Fehler stellen in der Regel API-Nutzungsfehler oder sehr wichtige Fehlerbedingungen dar. Beachten Sie, dass jede dieser ESE-APIs auch andere Fehler zurückgeben kann, die nicht für jede API dokumentiert sind. In diesen Fällen sollte der Aufrufer den Fehler genauso behandeln wie jeder andere Fehler, der von der API zurückgegeben wird. Der spezifische Fehlerwert kann dann für Diagnosezwecke wie die Ablaufverfolgung verwendet werden.

Im Allgemeinen sollte ein Wert, der größer als 0 ist, als Warnung interpretiert werden, ein Wert von 0 sollte als Erfolg interpretiert werden, und ein Wert, der kleiner als 0 ist, sollte als Fehler interpretiert werden. Keine anderen Muster in diesen Werten (z. B. Wertebereiche) sollte von einer Anwendung verwendet werden.

Wenn ESE auf einige der schwerwiegenderen Fehler stößt, wird ein Ereignisprotokolleintrag erstellt, der Details zu den Fehlern enthält. Die Protokollierungsebene kann durch Ereignisprotokollparameter gesteuert werden.

Einige Anwendungen erfordern die Möglichkeit, JET_ERRs als HRESULTs zurückzugeben. Das folgende C++-Beispiel zeigt, wie Diese Konvertierung vorgenommen wird:

    #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

Informationen zum Konfigurieren von Systemparametern für die Fehlerbehandlung finden Sie unter Fehlerbehandlungsparameter.

Weitere Informationen

Fehlerbehandlungsparameter

Fehlercodes für erweiterbare Speicher-Engine

JET_ERR