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:
|
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). |