JetGetErrorInfoW-Funktion

Artikel
06/13/2023

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 Wert des InfoLevel-Parameters 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 ist von InfoLevel abhängig.

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

Wert	Bedeutung
JET_ErrorInfoSpecificErr	pvContext wird als JET_ERR-/Fehlercode interpretiert, pvResult wird als JET_ERRINFOBASIC_W interpretiert, und die Felder der JET_ERRINFOBASIC_W Struktur werden entsprechend ausgefüllt.

grbit

Reserviert.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der Rückgabecodes zurück, die in der folgenden Tabelle aufgeführt sind. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

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 in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll ist. Dies kann für JetGetErrorInfo auftreten, wenn Folgendes auftritt: 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 SKU von Windows diese Funktion nicht unterstützt, wird dieser Fehler zurückgegeben.

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 in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll ist. Dies kann für JetGetErrorInfo auftreten, wenn Folgendes auftritt:

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 SKU von Windows 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 Zustand der Ausgabepuffer undefiniert.

Bemerkungen

Die JET_ERRINFOBASIC_W Funktion und JET_ERRCAT Gruppe von Konstanten enthalten Eine 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.
Kopfzeile	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).

JetGetErrorInfoW-Funktion