Extensible Storage Engine-Fehler
Letzte Änderung: Montag, 9. Januar 2012
Gilt für: Windows | Windows Server
Extensible Storage Engine-Fehler
Durch den Datentyp JET_ERR werden alle möglichen Fehler zurückgegeben von der Engine ESE (Extensible Storage)-API definiert. Eine Liste der Fehler-Flags, die für diese API definiert sind, finden Sie unter Extensible Storage Engine-Fehlercodes.
Nur die wichtigsten Fehler sind in der gesamten Dokumentation ESE-API dokumentiert. Diese Fehler stehen in der Regel API-Syntaxfehler oder Fehlerbedingungen sehr wichtig. Beachten Sie, dass diese ESE-APIs auch andere Fehler zurückgeben können, die nicht für jede API dokumentiert sind. In diesen Fällen sollte der Aufrufer einfach den Fehler behandeln, wie jeder andere Fehler, die von der API zurückgegeben wird. Der spezielle Wert kann dann zu Diagnosezwecken wie Ablaufverfolgung verwendet werden.
In der Regel ein Wert, der größer als 0 (null) wird als Warnung interpretiert werden soll, ein Wert von NULL als Erfolg interpretiert werden soll und ein Wert kleiner als 0 (null) als Fehler interpretiert werden soll. Keine anderen Mustern in diese Werte (z. B. Wertebereiche) sollte von einer Anwendung herangezogen werden.
Wenn ESE einige ernster Fehler findet, erstellt er einen Eintrag im Ereignisprotokoll, der Details über den Fehler enthält. Die Ebene der Protokollierung kann durch die Ereignisprotokoll-Parametergesteuert werden.
Einige Anwendungen erfordern die Fähigkeit, JET_ERRs als HRESULTs zurückgeben. Im folgende C++-Beispiel wird veranschaulicht, 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 über das Konfigurieren von Systemparametern für die Fehlerbehandlung finden Sie unter Fehler behandeln Parameter.