JetGetErrorInfoW-Funktion

Gilt für: Windows | Windows Server

JetGetErrorInfoW-Funktion

Die JetGetErrorInfoW-Funktion BAS_ der Datenbank-Engine.

Hinweis: Diese Dokumentation basiert auf einer vorläufigen Version der Extensible Storage Engine. Diese Informationen können geändert werden.

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

Parameter

pvContext

Der Kontext- oder Fehlerwert, für den die erweiterten Fehlerinformationen benötigt werden. Der übergebene Wert hängt vom InfoLevel-Parameterwert ab.

pvResult

Ein Zeiger auf einen Puffer, der die Informationen empfängt. Der Typ des Puffers hängt vom InfoLevel-Parameterwert ab. Der Aufrufer muss so konfiguriert werden, dass er den Puffer entsprechend ausrichtet.

cbMax

Die maximale Größe der übergebenen pvResult-Struktur.

InfoLevel

Der Typ der Informationen, die für die Fehlerinformationen/den Fehlerkontext abgerufen werden, wird durch den pvContext-Parameter angegeben. Das Format der in pvResult gespeicherten Daten hängt von InfoLevel ab.

In der folgenden Tabelle sind die möglichen Werte für diesen Parameter aufgeführt.

Wert

Bedeutung

JET_ErrorInfoSpecificErr

pvContext wird als JET_ERR/error-Code interpretiert, pvResult wird als JET_ERRINFOBASIC_Winterpretiert, und die Felder der JET_ERRINFOBASIC_W Struktur werden entsprechend ausgefüllt.

grbit

Reserviert.

Rückgabewert

Diese Funktion gibt den JET_ERR Datentyp mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errInvalidParameter

Einer der bereitgestellten Parameter enthält einen unerwarteten Wert oder einen Wert, der nicht sinnvoll ist, wenn er mit dem Wert eines anderen Parameters kombiniert wird. Dies kann für JetGetErrorInfo auftreten, wenn Folgendes geschieht:

  • Der angegebene InfoLevel-Parameterwert ist ungültig.

  • Der angegebene grbit-Wert ist ungültig.

  • Der cbMax-Wert des angegebenen pvResult-Parameterpuffers ist kleiner als die erforderliche Größe für die Ausgabe dieses InfoLevel-Parameters.

  • Für InfoLevel = JET_ErrorInfoSpecificErr ist der übergebene JET_ERR Wert für die Engine unbekannt.

JET_errDisabledFunctionality

Wenn diese Windows-SKU diese Funktion nicht unterstützt, wird dieser Fehler zurückgegeben.

Bei Erfolg wird der Ausgabepuffer, der für den angeforderten Fehlerkontext bzw. -wert geeignet ist, auf die angeforderten erweiterten Fehlerinformationen festgelegt.

Bei einem Fehler ist der Status der Ausgabepuffer nicht definiert.

Bemerkungen

Die JET_ERRINFOBASIC_W Funktion und JET_ERRCAT Gruppe von Konstanten enthalten Dokumentation zu den erweiterten Fehlerinformationen, die für InfoLevel = JET_ErrorInfoSpecificErr zurückgegeben werden.

Anforderungen

Anforderung Wert

Client

Erfordert Windows 8.

Server

Erfordert Windows 8 Server.

Header

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Unicode

Hinweis: Nur JetGetErrorInfoW (Unicode) wird implementiert. Diese API verfügt nicht über eine A-Version (ANSI).