Erweiterbare Storage Modulfehler

Gilt für: Windows | Windows Server

Erweiterbare Storage Modulfehler

Alle möglichen Fehler, die von der Extensible Storage Engine (ESE)-API zurückgegeben werden, werden vom datentyp JET_ERR definiert. Eine Liste der für diese API definierten Fehlerkennzeichnungen finden Sie unter Extensible Storage Engine Error Codes.

In der GESAMTEN ESE-API-Dokumentation werden nur die wichtigsten Fehler dokumentiert. Diese Fehler stellen in der Regel API-Verwendungsfehler oder sehr wichtige Fehlerbedingungen dar. Beachten Sie, dass eine dieser ESE-APIs auch andere Fehler zurückgeben kann, die für jede API nicht dokumentiert sind. In diesen Fällen sollte der Aufrufer einfach den Fehler behandeln, da er einen anderen Fehler aufweist, der von der API zurückgegeben wird. Der spezifische Fehlerwert kann dann für Diagnosezwecke wie ablaufverfolgung verwendet werden.

Im Allgemeinen sollte ein Wert, der größer als null ist, als Warnung interpretiert werden, ein Wert von Null als Erfolg interpretiert werden, und ein Wert, der kleiner als null ist, sollte als Fehler interpretiert werden. Keine anderen Muster in diesen Werten (z. B. Wertebereiche) sollten 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_ERR als HRESULTs zurückzugeben. Das folgende C++-Beispiel zeigt, wie Sie diese Konvertierung vornehmen:

    #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

Erweiterbare Storage Modulfehlercodes

JET_ERR